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Abstract 


MapTool  is  an  interactive  computer  program  for  the  display  of  common  marine  geophysical 
data.  At  present,  the  program  displays  isolines,  color-filled  contours,  navigation  tracklines,  and 
navigated  scalar  values  in  a  variety  of  styles.  A  variety  of  map  projections  are  supported.  This 
document  describes  the  basic  requirements  for  running  the  MapTool  program,  for  creating  various 
displays,  and  generating  hard  copy  output.  The  supported  data  file  formats  are  described.  All  of  the 
options,  displays,  menus,  and  windows  are  documented. 
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Section  1  —  Introduction 


MapTool  is  an  interactive,  workstation  based  computer  program  for  displaying  some 
common  marine  geophysical  data.  It  uses  the  OpenLook™  and  XView™  toolkits  for  its  graphical 
user  interface,  and  the  Uniras  agX/Toolmaster™  as  its  graphical  programming  interface.  It 
operates  in  an  XI 1  environment  for  interactive  use,  and  supports  a  variety  of  hard  copy  devices. 

A  few  of  the  features  of  the  MapTool  program  include: 


•  Interactive  display  of  contour  isolines,  with  optional  color-fill  between  isolines.  Also 
supports  missing  data,  and  filtering  interpolated  data. 

•  Display  of  navigation  tracklines,  with  full  control  of  annotations,  tickmarks,  label 
orientation,  and  color. 

•  Supports  the  "Drag-and-Drop"  metaphor  for  importing  data  files  from  the 
OpenWindows  File  Manager. 

•  Produces  PostScript,  rasterfile,  and  metafile  hardcopy  outputs. 

•  Displays  scalar  values  in  a  variety  of  styles,  including  actual  value,  wiggle-style, 
scaled  symbols,  and  value  filtering. 

•  Supports  a  variety  of  map  projections  and  ellipsoids. 

•  Interactive  range  and  bearing  measurements. 

The  purpose  of  this  document  is  to  provide  basic  information  about  running  the  MapTool 
program,  importing  data,  creating  a  map  display,  and  generating  hard  copy  output.  This 
document  explains  all  of  the  options,  displays,  menus,  windows,  necessary  and  optional  features, 
system  requirements,  and  data  file  formats.  Examples  of  windows,  files,  and  outputs  are  given. 

The  development  of  the  MapTool  software  has  been  done  under  tire  auspices  of  the  WHOI 
Digital  Image  Analysis  Laboratory  (DIAL).  The  DIAL  facility  has  been  established  within  the 
Geology  and  Geophysics  Department  in  order  to  establish  and  centralize  capabilities  for  the 
processing,  display,  and  archiving  of  a  wide  variety  of  large- volume,  marine  geological  and 
geophysical  digital  data  sets. 


1.1  System  Requirements 

The  MapTool  program  requires  the  use  of  an  interactive,  XI  1-based,  Unix  workstation.  The 
following  are  the  characteristics  of  a  MapTool  compatible  system: 

•  SunOS  Version  4.1 .3,  or  Solaris  2.2  or  higher. 

•  OpenWindows  Version  3 

•  XView  Version  3 
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•  S-bit  Color  display 

•  24  MB  of  system  mrmorv.  Additional  memory  will  bo  needed  for 
anything  more  than  a  simple  chart  display. 

•  Unirns  agX /Tool master  run-time  support.  Version  o\’3H. 

As  an  XVI -based  program,  AfarTiv’  can  also  operate  as  a  client  program  on  a  remote  host, 
with  the  local  server  managing  the  display,  mouse,  and  keyboard.  This  is  accomplished  bv  setting 
the  DICLAY  environmental  variable  on  the  client  host,  and  authorizing  remote  access  on  the 
server  host.  Consult  the  appropriate  XI  1  and  OpenWindows  documentation  for  turther  details 
concerning  the  configuration  of  an  appropriate  client-server  relationship. 


1.2  Document  Conventions 


This  document  uses  typographical  methods  to  denote  various  components  of  the  MiipTool 
program: 

•  Words,  phrases,  and  titles  taken  directly  from  AFuTcc;  windows  are  displaced  in  a 

fixed-width,  sans-serif  font.  For  example,  the  title  of  the  main  window  of  the  MapTool 
program  is  shown  as  "C  .a  7  .  .  .  :  e  i :  r.  ...  .  '.  r 

•  Interactive,  command-line  based  dialogues  are  also  shown  using  a  mono-spaced, 

typewriter  font.  When  appropriate  in  such  dialogues,  user  responses  will  be  highlighted 
in  bold.  For  example,  in  the  following  dialogue  Cv:  part  of  the  XUipTool  program),  the  user- 
types  the  word  "date"  followed  by  [:-  1,  and  the  operating  system  responds  In- 

displaying  the  current  date  and  time: 

date 


•  Special  key  sequences  are  denoted  by  enclosing  in  square  brackets,  and  using  small 
capital  letters.  A  fixed-width,  sans-serif  font  is  also  used.  For  example,  the  sequence 
IRK  :  '=!•.:: |  refers  to  pressing  the  key  labelled  "Return,"  The  sequence  ( jx.  :  ]  refers  to 
pressing  the  "Select"  button  on  the  mouse  or  pointing  device.  When  more  than  one  key  or 
button  need  to  be  pressed  simultaneously,  then  the  entire  sequence  is  enclosed  in  square 
brackets,  with  individual  sequences  separated  by  the  "/"  character.  For  example,  the 
sequence  [Sh  :  :  S:~  :  ]  refers  to  simultaneously  pressing  the  "Shift"  kev  on  the 

keyboard  and  the  "Select"  button  on  the  mouse. 
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Section  2  —  Setup  and  Start-up 


Prior  to  using  MapTool,  it  is  necessary  to  configure  the  Unix  user  environment.  This  will 
typically  take  the  form  of  adding  statements  to  a  user's  .cshrc  and  .Xdef  aults  files.  In 
addition,  it  may  be  necessary  to  gain  access  to  file  systems  containing  the  MapTool  software.  This 
section  will  provide  information  for  a  common  configuration. 

On-line  copies  of  these  setup  file  modifications  can  be  found  in  the  file 
$DIALHOME/samples/dial_setup.  Other  files  (sample  data  files,  attribute  files,  and  so  forth) 
can  also  be  found  in  the  same  directory. 


2.1  File  System  Access 

If  the  MapTool  software  is  not  available  on  a  locally  mounted  file  system,  it  will  be 
necessary  to  remotely  mount  from  another  host.  The  preferred  method  is  to  use  the  automount 
facility  provided  with  SunOS.  This  service  automatically  and  transparently  mounts  an  NFS  file 
system  as  needed.  The  configuration  and  operation  of  the  automounter  and  NFS  is  well  beyond 
the  scope  of  this  user  manual.  If  needed,  consult  the  system  administrator  for  your  local  host 
system. 


In  a  simple  case,  where  the  local  host  is  running  Sun  OS  4.1.x,  with  a  single  automount 
file,  the  following  sequence  can  be  used  (must  be  the  root  user): 

1.  Add  an  entry  into  the  automount  file  (typically  /etc/auto  .mount): 

/home/Dial  -ro  tone : /files/tone/Dial 


2.  If  the  automount  daemon  is  currently  running,  kill  it.  Note  that  one  must  send  a 
SIGTERM  signal  (via  kill  -15)  to  properly  terminate  the  automount  daemon. 

3.  Restart  the  automount  daemon.  Under  SunOS  4.1.x,  the  automount  daemon  is  usually 
started  from  the  file  /etc/rc.  local.  Look  in  this  file  to  see  the  proper  way  to  initiate. 

In  this  example,  the  remote  host  tone  contains  the  necessary  MapTool  program  files, 
which  are  then  locally  mounted  to  the  file  system  /home /Dial .  In  cases  where  either  Yellow 
Pages  or  NIS  systems  are  in  effect,  different  procedures  will  be  required.  Again,  consult  the 
system  administrator  for  your  local  host  system  for  implementation  details. 
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2.2  User  Environment 

Prior  to  starting  A iapToo!,  it  is  necessary  to  set  up  the  user  environment.  Since  this 
procedure  must  be  followed  every  time  a  user  logs  into  the  svstem,  it  is  common  to  place  these 
commands  in  a  user's  .csr.rc  tile.  A  tvpica!  entrv  would  consist  of  the  following: 


In  addition,  in  order  to  properly  interact  with  the  XI 1  server  on  the  local  display  host, 
each  user  should  add  the  following  entries  to  the  file  Chime  .  Hue :1a v. it  s: 


u  i :  :  r 


Note  again  that  these  initialization  settings  are  samples  onlv  —  vour  local  configuration 
may  be  different.  After  making  these  changes  to  :  and  :  -  ,  ,  it  is  best  to  log  out, 

then  log  back  in  to  make  sure  the  changes  are  set  properly  within  the  X  Window  Manager. 


2.3  Running  MapTool 

I  iovided  a  piopei  environment  has  been  initialized,  starting  the  A  lap  lee/  program  is  best 
done  by  running  the  program  in  the  background.  There  are  at  least  two  wavs  to  do  this.  First, 
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from  the  Unix  C-shell  command  line,  type: 

%  MapTool  [~f  map filename]  & 

Note  the  option  -f  map  filename  parameter  on  the  command  line.  This  allows  for  the  initial 
loading  of  a  saved  map  file  prior  to  display.  Refer  to  Section  5.1.1  for  how  to  create  a  map  file.  If 
no  map  file  is  given,  then  the  default  parameters  are  used. 

A  second  method  of  starting  the  MapTool  program  is  to  add  an  entry  into  the  file 
$HOME  /  .  openwin-menu,  which  will  start  the  program  when  invoked  from  the  OpenWindows 
Workspace  Menu.  A  typical  entry  in  $HOME/  .  openwin-menu  would  look  something  like: 

"MapTool..."  exec  $DIALHOME/bin/MapTool 


Note  that  MapTool  supports  the  standard  XView  command  line  start-up  options.  For 
example,  use  the  option  ”-Wi"  to  start  MapTool  as  a  closed  Icon.  See  the  appropriate  XView  and 
OpenWindows  documentation  for  additional  start-up  options. 
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Section  3  —  MapTool  Display 


The  MapTool  program  is  an  interactive,  workstation-based  program.  As  such,  all  user 
interaction  is  done  through  display  windows.  This  section  describes  the  main  map  display. 
Subsequent  sections  describe  the  various  pop-up  windows,  menus,  and  buttons. 


3.1  Map  Display 

1  he  main  display  (or  base)  window  of  the  ,\ ! ee.’  program  is  a  two-dimensional  map, 
somewhat  analogous  to  a  sheet  of  paper.  Various  sized  ’  sheets  of  paper"  (or  screens)  can  be 
selected  for  drawing  a  map  (see  Section  3.4.1,  Program  Properties);  in  all  cases,  the  map  that  is 
displayed  will  fit  the  largest  map  possible  while  preserving  the  proper  aspect  ratio.  The  drawing 
tools  used  to  make  the  map  are  fixed  in  size,  such  that  a  thin  line  drawn  on  a  small  screen  will 
be  the  same  width  on  a  large  screen.  Regardless  of  the  state  of  the  MapTool  program,  a  map  is 
always  defined.  In  most  cases,  the  map  will  have  borders,  labels,  and  data  displayed  inside. 

1  lowever,  a  map  can  also  be  defined  with  no  borders  or  labels,  and  without  data  being  displayed. 
A  map  then  is  defined  as  simple  a  view  of  a  specific  geographic  area.  All  of  the  elements  of  how 
that  area  is  to  be  viewed  are  user-options,  but  an  area  is  alwavs  defined. 

When  the  MapTool  program  is  first  started  the  base  window  "M  e  ':  .  Vers* ion 
•  -1  displayed.  Note  that  this  is  a  sample  displav  - —  the  displav  a  user  will  see  will  depend  on 
default  values  selected. 


r'SO-'  O' 
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Figure  3-1 .  MapTool  Base  Window 


3.2  Scroll  Bars 

Since  the  size  of  the  map  area  may  exceed  a  user's  physical  screen  or  size  of  the  base 
window,  both  horizontal  and  vertical  scroll  bars  are  provided  to  view  a  portion  of  the  map  area. 
When  the  Screen  Size  attribute  is  set  to  Full  Screen  (see  Section  5.4.1),  then  the  scroll  bars 
are  only  needed  if  the  base  window  is  sized  less  than  the  full  screen.  When  Screen  Size  is  set 
to2X  Full  Screen  or  4X  Full  Screen,  then  the  scroll  bars  are  need  to  view  the  entire  map 
area. 


3.3  Base  Window  Footers 

Both  the  left  and  right  window  footer  locations  are  used  to  display  various  information 
messages  to  the  user.  These  messages  will  be  described  in  the  sections  where  the  messages  are 
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generated.  Note  also  that  many  of  the  pop-up  windows  will  also  contain  important  information 
in  their  window  footers. 


3.4  [Update]  Button 

During  a  typical  interactive  ADyTcc:  session,  the  user  mav  import  a  variety  of  files,  and 
then  change  each  file  s  display  characteristics  until  the  desired  map  is  drawn.  The  purpose  of  the 
Id:  ;  A':  el  button  is  to  redraw  the  current  map,  so  that  changes  to  data  or  display  characteristics  are 


shown.  If  the  display  currently  shown  matches  all  of  the  user  settings,  then  the  [c\  button 

will  be  disabled.  When  the  setting  "l  :: ;  -ran.  =  :  .  c  mee  :  rS;  y.  v  •joda is  set  to 


Automat-  :i  r  (see  Section  n.4.1 ),  then  the  map  display  will  be  updated  whenever  necessary,  and 
the  |U>  iv, 1  button  will  not  be  av  ailable. 

Selecting  the  io.T  r  menu  item  from  the  base  window  frame  pop-up  menu  will  also 
cause  the  map  area  to  be  totally  redrawn 


3.5  Drag-and-Drop 


1  wo  methods  are  available  for  i m porting  data  into  the  A l.m  f  ee/  program.  One  method  is 
through  the  use  of  the  hi  it :  : :  r  r ...  menu  item  described  in  Section  5T  .4.  Additionally, 
supported  data  files  may  be  dropped  on  to  the  map  area  from  programs  that  support 
"dragging"  of  files  to  selected  targets.  For  example.,  the  Open  Windows  File  Manager  allows 
"dragging"  of  files  to  other  programs.  To  use,  use  the  |  j:  :]  button  on  the  mouse  to  first  select 

a  file  in  the  File  Manager  window,  then,  holding  down  the  [c,  ;  • :  ]  button,  "drag"  the  file  until 

its  icon  representation  is  on  top  of  the  A  D  r  Tec.'  map  area.  Release  the  ]  button  and  the  file 

will  be  loaded. 
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Section  4  —  Mouse  and  Keyboard  Commands 


Control  of  the  MapTool  program  is  accomplished  primarily  through  the  use  of  the  mouse 
and  keyboard.  The  mouse,  in  conjunction  with  mouse  buttons,  is  used  to  interact  with  the  main 
display  and  control  pop-up  windows.  Options  are  selected  by  clicking  the  mouse  in  check  boxes 
and  other  control  elements.  The  keyboard  is  used  to  enter  values  and  file  names  into  entry  fields. 


4.1  Mouse  Tracking 


While  the  MapTool  program  is  running,  the  location  of  the  mouse  pointer  is  continuously 
tracked  and  converted  to  map  coordinates.  The  default  tracking  action  is  to  display  the  geodetic 
coordinates  (latitude  and  longitude)  of  the  tip  of  the  mouse  pointer  in  the  left  window  footer.  As 
the  mouse  is  moved,  these  values  will  be  automatically  updated.  If  the  [Shift]  key  is  pressed 
during  mouse  tracking,  then  the  projected,  cartesian  coordinates  (X  &  Y)  will  be  shown  in  the 
footer.  When  [Shift]  is  released,  geodetic  coordinates  will  be  shown. 

Note  that  the  mouse  tracking,  coordinate  display  only  occurs  while  the  mouse  pointer  is 
inside  the  current  map  area. 


4.2  [Select]  Actions 

While  the  mouse  point  is  inside  the  current  map  area,  pressing  the  [Select]  button  on  the 
mouse  (normally  MB1,  the  "left"  button)  allows  a  user  to  measure  the  distance  between  two 
points.  This  procedure  is  accomplished  by: 

1 .  Move  the  mouse  pointer  to  the  location  of  the  starting  point  of  the  line  to  be  measured. 
Use  the  mouse  tracking  feature  (see  Section  4.1)  to  precisely  locate  the  pointer  position  in 
geodetic  coordinates. 

2.  Press  and  hold  ("drag")  the  [Select]  button.  A  line  will  be  drawn  from  the  start  point  to  the 
current  point.  The  endpoints  of  the  line  will  be  displayed  in  the  left  window  footer.  The 
range  and  bearing  from  the  first  point  to  the  endpoint  will  be  displayed  in  the  right 
window  footer. 

3.  Release  the  [Select]  button.  The  pointer  returns  to  normal  shape,  the  line  disappears,  and 
the  left  window  footer  returns  to  coordinate  tracking. 


Note  that  the  line  to  be  measured  must  be  inside  of  the  current  map  area. 
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4.3  [Adjust]  Actions 

While  the  mouse  pointer  is  inside  the  current  map  area,  pressing  the  [a  1  button  on 
the  mouse  (normally  MB2,  the  "middle'  button)  allows  a  user  to  "zoom  in"  to  the  map  area  bv 
interactively  determining  a  new  set  of  map  chart  boundaries.  This  procedure  is  accomplished  bv: 

1 .  Move  the  mouse  pointer  to  the  location  ot  one  corner  ot  the  new  area.  Use  the  mouse 
tracking  feature  (see  Section  4.1  >  to  preciselv  locate  the  pointer  position  in  geodetic 
coordinates. 

2.  Press  and  hold  ("drag")  the  (A  ]  button.  A  box  will  appear  showing  the  new  chart 
boundaries,  and  will  move  as  the  mouse  is  moved.  The  geodetic  corners  of  the  box  will  be 
displayed  in  the  left  window  footer.  A  small  circle  will  appear  at  the  tip  of  the  mouse 
pointer,  indicating  a  "drag"  operation. 

3.  While  dragging  the  mouse,  press  the  [Bsc]  key  at  anytime  to  cancel  the  zoom  in  operation. 

4.  When  the  desired  opposite  corner  of  the  chart  box  is  displaced,  release  the  j.A  :  | 
button.  The  chart  boundarv  properties  will  be  updated. 

Note  that  it  is  not  possible  to  extend  tire  '  zoom-in"  operation  to  a  point  outside  of  the 
current  map  area.  Instead,  use  a  "zoom-out.  followed  bv  a  "zoom-in.' 


4.4  [Menu]  Actions 

While  the  pointer  is  inside  the  current  map  area,  pressing  the  [:a  a  ]  button  on  the  mouse 
(normally  MB3,  the  right'  button)  activates  tire  '  1, :  :::  A.:: "  pop-up  menu.  The  purpose  ot  this 
menu  is  to  expand  the  chart  boundaries  of  the  current  map,  while  keeping  the  same  map  aspect 
ratio  and  center  of  the  map.  When  invoked,  five  possible  menu  items  are  available: 


10  ? 


100  Per cone 
30  0  Pe:  ro::: 


Both  the  latitude  and  longitude  spans  are  increased  bv  ten  percent. 
The  increase  is  distributed  equally  between  the  minimum  and 
maximum  geodetic  values. 

Botli  the  latitude  and  longitude  spans  are  increase  bv  33  percent, 
equally  distributed  between  minimum  and  maximum  values. 

Both  spans  are  increased  by  100  percent,  equallv  distributed. 

Both  spans  are  increased  by  300  percent,  equallv  distributed. 


Auto-Locar.e  Par  a  When  selected,  the  bounds  of  all  the  data  currentlv  in  use  is 

determined  and  the  chart  boundaries  are  adjusted  so  that  all  data 
will  be  visible. 

If  the  attribute  Prc  ora::.  P  i :  car:  i-oz  :  I  is;:  lay  Apia:  a  (see  Section  5.4.1)  is  set  to 
Manual,  then  the  map  area  will  be  updated  the  next  time  the  map  is  re-displaved.  If  set  to 
Automatic,  then  the  map  area  is  updated  immediatelv. 
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Section  5  —  Menus 


This  section  describes  the  pull-down  and  pop-up  menus  in  the  MapTool  program.  It  is 
assumed  that  the  user  is  familiar  with  the  mouse  actions  necessary  to  manipulate  menus.  All  of 
the  menus  described  are  part  of  the  main  MapTool  display  window  (see  Section  3.1). 


5.1  File  Menu 


The  File  menu  is  a  menu  button  that  contains  actions  that  deal  with  the  input  and  output 
of  files.  These  files  may  relate  to  data,  program  properties,  or  printing. 


5.1.1  Load... 

The  Load...  menu  item  is  used  to  load  a  previously  saved  map-file  into  the  MapTool 
program.  A  map-file  contains  a  complete  list  of  all  display  parameters  and  options,  along  with  a 
list  of  all  the  data  files  used.  When  selected,  the  "MapTool :  Load  File:"  pop-up  window 
appears  if  not  already  visible: 


MapTool:  Load  File 


Directory:  /files/to»e/peteri/source/Map2 

■f  - ..  (Go  up  a  level) 

Q  foo.map  _  ' 

Q  Foo2.tnap 
0  F  o63,  map 
G  Icons 


Name:  Foo2.maPj 


f  Select  a  Map  Parameter  File  to  Load 


Figure  5-1 .  MapTool  Load  File  Pop-up  Window 
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Use  the  mouse  and  keyboard  to  select  a  map  file  to  load.  Onlv  those  files  which  have  been 
created  using  the  .:  :  ::  :•  :  .  .  .  .  function  (See  Section  5.1.2)  will  be  displaced.  In 

addition,  one  can  directly  type  in  a  filename  to  be  loaded 


5.1.2  Save... 

The  Save-...  menu  item  is  used  to  save  all  of  the  parameters,  options,  and  file  names  used 
to  create  the  current  map  in  a  file  for  use  at  a  later  time.  These  fries  can  be  loaded  either  when 
starting  the  MapTool  program  (See  Section  2.3)  or  bv  invoking  the  .  ;  piio  :  sm/ui. 

menu  item  (sec  Section  n.1.1).  When  invoked,  the  Map  look  Save  File  pop-up  window  appears: 


MapTool:  Save  rile 


D irectory:  /f lie r,'"c-ne.-'t erer 
ih  ..  (Go  no  i  iove-i: 


Name:  A 


Figure  5-2.  MapTool  Save  File  Pop-up  Window 


Use  the  mouse  and  keyboard  to  enter  the  name  of  a  file  in  the  displaced  directory  to  store 
the  map  information.  All  files  (not  just  previously  saved  files'  are  shown. 


5.1.3  New 


The  New  menu  item  is  used  to  reinstate  the  A‘.w7ee/ 
selected,  the  following  actions  are  taken: 


display  to  its  initial  state.  When 


MapTool  Version  2 


re  5-2 


User's  Manual 


-21- 


•  All  data  files  that  have  been  imported  are  removed. 

•  All  of  the  display  properties  are  reset  to  the  values  used  at  program  startup. 

•  The  map  display  is  cleared,  and  an  update  event  is  generated. 

If  any  data  files  are  open  for  writing  or  have  been  modified,  then  user  confirmation  will 
be  required. 


5.1.4  Import... 

The  Import...  menu  item  is  used  to  import  data  files  into  the  MapTool  program.  When 
selected,  the  "MapTool :  Data  Chooser"  pop-up  window  appears  if  not  already  visible: 


MapTool:  Data  Chooser 
Directory:  /fiies/tone/peter!/source/Map2 

^TfCoup  a  level)  ;  ’ 

0  flg.grd 
T  CD  Icons,  yy 
0  SiteA.grd 

Q  :cruise.attl’:TttA'  ■■  y  f;t  y-S^fl-t; 

0  echar.tes? 

D  foo.grd 

0  nav.cruise  ■ 

.  0  rform.gr  d 

0  rtorm.grd~  yy  ’  y;  ■  ■  WMmfT 


Name:  t  .  _ _ _ 

i'lrnportbata  h'ilei 

,  Select  a  Data  file  to  Import  into  Map  : 


Figure  5-3.  MapTool  Data  Chooser 


Data  files  to  be  imported  are  selected  by  navigating  the  Data  Chooser,  via  the  mouse 
and  keyboard  commands.  Two  notes  about  the  Data  Chooser: 

•  Only  valid  data  files  (See  Section  6)  are  shown  in  the  Data  Chooser  scrolling  list,  along 
with  the  sub-directories  of  the  current  directory.  However,  the  user  may  type  the  name  of 
a  data  file  directly  into  the  Name:  field  if  the  desired  data  file  is  not  present  in  the  scrolling 
list. 

•  The  Data  Chooser  does  not  always  recognize  NTS  automounted  file  systems 
automatically.  To  access  these  file  systems,  it  may  be  necessary  to  type  the  name  of  the  file 
system  directly  into  the  Name  :  field,  then  either  type  [return]  or  use  the  mouse  to 
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1  the  ! 


button. 


Once  the  desired  file  is  selected,  either  double-click  on  the  file  name,  or  use  the  mouse  to 
[Sr:  iv  a  ]  the  | Ik;  Data  F; :  1  button.  Once  selected,  the  MapTool  propram  will  attempt  to 
read  data  from  the  desired  file.  If  successful,  the  file  will  become  available  for  displav  depending 
on  its  type. 

In  addition  to  using  the  T  nr  a  ,  the  M.;r!  ec.  program  supports  the  Drag  and 

Drop  metaphor  for  importing  data  files.  See  Section  3.5. 


5.1.5  Export... 

The  Expert...  menu  item  is  ; 


5.1 .6  Print 

The  Iced  nr  .  .  .  menu  item  is  used  to  select  the  output  format  for  generation  of  hardcopy 
products.  For  a  complete  description,  see  Section  7.  Hardcopv  Output. 


5.1.7  Quit 


The  Quit  menu  item  is  used  to  terminate  the  A!.::T.v:  program.  It  there  are  any  data  files 
open  for  writing  or  that  have  been  changed  prior  to  saving,  then  user  confirmation  will  be  needed 
to  exit  the  piogiam.  In  addition  to  the  .  a  it  menu  item,  the  Al.  irleel  program  can  be  terminated 
by  selecting  Quit  from  the  base  window  pop-up  as  provided  by  the  OpenWindows  Window 
Manager. 


5.2  View  Menu 

The  View 

map. 


Menu  contains  menu  items  for  viewing  various  information  about  the  current 


5.2.1  Data  Summary... 

I  he  Data  Summary...  menu  item  is  used  to  review  and  manage  the  data  files  currently 
used  for  the  MapTool  display.  When  selected,  the  "MarTi  c  :  :  Fata  Jummarv"  pop-up  window 
appears. 
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For  each  data  file  currently  in  use,  the  following  information  is  given: 

•  The  name  of  the  file.  When  a  file  is  selected  from  the  list,  the  entire  path  and  file  name  is 
displayed  in  the  left  window  footer. 

•  The  type  of  the  data,  as  described  by  attributes. 

•  An  indication  of  the  size  of  the  file.  For  gridded  data,  the  number  of  rows  and  columns  is 
shown.  For  navigation  and  alongtrack  data,  the  number  of  data  points  is  shown. 

A  data  file  will  be  added  to  this  list  whenever  a  file  is  successfully  loaded  into  the  MapTool 
program,  either  by  the  File  :  Import...  menu  (see  Section  5.1.4) ,  or  by  a  drag-and-drop 
operation  (see  Section  3.5).  To  remove  a  file  from  the  list,  and  hence  remove  from  the  MapTool 
display,  first  select  the  file  by  using  the  [Select]  button  on  the  mouse,  then  the  [remove  file 
From  display]  button. 


5.2.2  Display  Summary... 


The  Display  Summary.  .  .  menu  item  is  not  available. 


5.2.3  Contour  Legend... 


The  Contour  Legend...  menu  item  is  used  to  view  how  colors  are  associate  with  gridded 
data  values  displayed  as  either  images  or  color-filled  contours  (see  Section  5.4.5.3).  When 
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invoked,  the  " !•■  a  :  :  :  I  r  ..  e  11  pep-up  window  is  made  visible: 


-e  MapTool:  Color  Scale 

Style:  Stes&ed  5c? is  Draw  Seal? 


[ 

1 


L _ _ 


Figure  5-5.  \ 'p.o  /  col  Co. or  Scale 


Unlike  other  displays,  the  "v-pT:  :  1 :  Del;  r  JoaL~"  pop-up  does  not  automatically 
update  as  new  color  scales  are  produced.  In  order  to  see  the  latest  color  scales,  the  user  must 
select  the  [D:-,v.c  S  ',.:  1  button.  The  pop-up  window  can  be  resized  bv  dragging  on  the  corners. 
The  available  options  for  this  window  are: 

,j  i  V -I- o  .  Selects  the  style  of  contour  legend  to  be  displaced.  Note  that  this 

setting  will  also  determine  the  style  ot  the  legend  drawn  in 
hardcopy  outputs.  Available  stvles  are: 

St.  eppoa  Scsj-e  This  style  ot  legend  shows  color  as  discrete  boxes,  labelled  with  the 
range  of  values  corresponding  to  each  color. 

C°nt  i  nuoe.s  scale  1  his  style  of  legend  show  a  smooth,  continuous  band  of  colors. 

Points  corresponding  to  actual  values  are  labelled  on  the  left  side  of 
the  legend. 


If  no  color  scale  information  is  in  use,  then  the  [:  .  :.  .  .  j  button  will  be  disabled. 
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5.3  Edit  Menu 

The  Edi  t .  .  .  menu  is  not  available. 


5.4  Properties  Menu 


The  Properties  Menu  is  a  menu  button  containing  items  that  relate  to  how  MapTool 
will  display  map  data.  Groups  of  properties  are  collected  under  various  categories. 


5.4.1  Program... 

The  Program...  menu  item  is  used  to  set  some  general  properties  of  how  the  MapTool 
program  will  operate,  and  as  a  collection  point  for  properties  that  do  not  easily  fit  into  other 
categories.  When  invoked,  the  "MapTool :  Program  Properties"  pop-up  window  will  be 
displayed: 


$  MapTool:  Program  Properties 

MapTool -Version  2.0 

Digital  Image  Analysis  Laboratory 
Woods  Hole  Oceanographic  Institution 


Screen  Size:  £j  Fullscreen 
Display  Update:  .yj  Manual 

Hardcopy  Label:  Hydrosweep  Bathymetry  -  20m  Contour  interval 


Apply ')  Reset  )  •  - 

Save  as  Default ) 


Figure  5-6.  MapTool  Program  Properties 


The  following  options  are  available: 
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Affects  the  si/e  of  the  map  that  will  be  displayed  on 
the  screen.  Possible  selections  are: 

1  he  entire  screen  is  used.  When  the  Map  Window  is 
fully  expanded,  the  entire  map  should  be  visible. 

An  area  that  is  twice  as  wide  and  twice  as  high  as  the 
screen  is  used.  The  entire  map  will  never  be  visible, 
but  can  be  viewed  bv  using  the  scroll  bars. 

An  area  tour  times  the  width  and  height  ot  the 
screen  is  used  tor  the  map.  Lse  scroll  bars  to  view 
portions  ot  the  map. 

Controls  when  the  map  screen  is  updated.  Updates 
are  needed  when  data  is  loaded  or  removed,  or 
when  display  properties  are  changed.  Possible 
selections  are: 

W  hen  Manual  is  selected,  display  updates  occur 
when  either  the  ( A  .  1  button  is  selected  (see 

section  3.3),  or  when  the  entire  window  is  refreshed. 
\\  hen  Automatic  is  selected,  display  updates  occur 
whenever  events  trigger  them.  For  example, 
importing  a  new  data  tile  will  cause  an  update. 

I  ho  user  may  enter  a  character  string  that  will  be 
printed  along  the  bottom  edge  ot  a  map  when 
generating  hardcopy 


[Am  :.v  i 


Selecting  this  button  causes  those  values  chosen  to 
be  used  tor  subsequent  operation. 


Selecting  this  button  causes  anv  value  modified  to 
be  set  back  to  its  unmodified  state. 


Selecting  this  button  causes  the  values  currently  in 
use  to  be  saved  in  a  user  initialization  file,  and  will 
be  loaded  the  next  time  the  A1  uvlool  program  is 
started,  or  when  a  New  map  is  selected. 


5.4.2  Selection... 

The  select  ion...  menu  item  can  be  used  to  edit  the  display  properties  of  whichever  data 
file  is  selected  from  the 'UAvA  :  :1:  Z  .-oca  P  a::  ::. ary’  pop-up  window  (See  Section  5.2. 1).  When 
selected,  the  appropriate  pop-up  window  for  the  particular  data  type  is  displayed,  showing  the 
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display  attributes  for  the  selected  data  file.  If  no  data  file  is  currently  selected,  then  the 
Selection...  menu  item  is  not  available. 


5.4.3  Chart... 

The  Chart...  properties  menu  item  is  used  to  select  properties  that  control  the  chart  area 
of  the  map.  This  information  includes  the  location  of  the  map,  the  map  projection  used,  and  the 
map  scale  for  certain  types  of  hardcopy.  When  Chart...  is  selected,  the  "MapTool :  Chart 
Properties"  pop-up  window  is  displayed: 


jt'  MapTool:  Chart  Properties 

.  (North) 

Max  Latitude 

27  20.01  tj 

Min  Longitude  49  15,01  W  43  59.99  W  Max  Longitude 

r  (West)  (East) 

24  59.99  N 

Min  Latitude 

,  (South) 


Map  Scale:  1 :  50000 

Rotation:  0  /  !  tj 

v.  Computed. Size:  x:  417,4  inches 

y:  208.9  inches 

Projection:  yj  tambert  Conformal 

Elipsoid:  O  WGS  1984 

False  Easting:  0 

False  Northing:  0 

Central  Meridian:  00  00.00  E 

Std.  Parallel  #l:  33  00.00  N 

■ivil)  Central  Scale  Factor  1.0000 

Base  Latitude;  0  00,00  N 

Std.  Parallel  #2:  45  00.00  N 

um*o»e;  it ; .  ■  /  Tj 

.Apply)  ■ 

Reset)  Save  as  Default } 

Figure  5-7.  MapTool  Chart  Properties 


The  following  settings  are  available: 

Max  Latitude  (North):  Geodetic  coordinate  for  the  maximum  latitude 

value  in  the  map  area.  This  will  be  the  "Northern" 
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Mi  n  l.iOnc;:;:.u::-  ( ;•  r 


Max  L o n a .1 1 1 1 y e  (Ea s r  )  : 


Min  Latitude  r.  i  : 


border  of  the  map  area.  Note  that  the  map  mav 
actually  contain  points  greater  than  this  value, 
depending  on  the  map  projection  and  rotation, 
hater  values  as  either  (1 )  decimal  degrees,  (2)  whole 
degrees  and  decimal  minutes,  or  (3)  whole  degrees 
and  minutes  and  decimal  seconds.  Indicate  the 
desired  hemisphere  with  either  a  "N"  or  "S",  or  use  a 
positive  value  tor  the  Northern  hemisphere  or  a 
negative  value  tor  the  Southern  hemisphere. 
Geodetic  coordinate  tor  tire  minimum  longitude 
value  in  the  map  area.  This  will  be  the  "Western" 
border  of  the  map  area.  Depending  on  projection 
and  rotation,  map  may  contain  points  less  than  this 
value.  Indicate  the  hemisphere  with  either  a  "W"  or 
"E' ,  or  use  a  positive  value  tor  the  Eastern 
hemisphere  or  negative  tor  the  Western  hemisphere. 
Geodetic  coordinate  for  the  maximum  longitude 
value  in  the  map  area.  This  will  be  the  "Eastern" 
border.  Points  displayed  will  depend  on  projection 
and  rotation.  Must  include  hemisphere  designation. 
Geodetic  coordinate  for  the  minimum  latitude  value 
in  the  map  area.  This  will  be  the  "Southern"  border. 


Map  Sc  we  :  I  he  natural  scale  to  be  used  for  the  map,  only  when 

generating  certain  hard  copv  outputs. 

kc  ;.  a::  i :  r. :  [  he  number  of  degrees  of  rotation  for  the  projected 

map  coordinates,  measured  clockwise  from  true 
North.  \  a  lid  values  range  from  -45  to  45  degrees 
Note  that,  at  present,  gridded  data  oniinot  be 
displayed  on  rotated  maps. 

Computed  Size  (>:  i  y;  :  These  fields  display  the  computed  size  of  the  map 

area  selected  using  the  Map  3  rale  value  displayed. 
I  hese  values  do  not  include  labels,  legends,  and  so 
forth,  that  fall  "outside"  the  map  area. 

Project  r  : The  type  of  map  projection  to  be  used.  When  a 

particular  projection  is  selected,  corresponding 
projection  parameters  will  become  enabled  or 
disabled  as  needed.  Possible  projection  values  are: 

Merc  at  :  r  A  cylindrical,  conformal  projection. 

The  Universal  4  ransverse  Mercator  projection  is  a 
special  case  of  a  T  ransverse  Mercator  projection. 
iicir.G  verse  we  rear  :  r  A  transverse  cylindrical,  conformal  projection. 
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Lambert  Conformal 
Azimuthal  Stereographic 


A  conic,  conformal  projection. 

An  azimuthal,  conformal  projection. 


Ellipsoid: 


Sphere 
WGS  1984 

WGS  1972 
Int'l  1924 

Clarke  1880 
Clarke  1866 


Describes  the  shape  and  size  of  the  ellipsoid  used  in 
the  selected  map  projection,  by  setting  the 
Equatorial  (a)  and  Polar  (b)  radius  of  the  Earth. 
Possible  values  are: 

a  =  6,371,000.0  m,  b  =  6,371,000.0  m.  A  spherical 
earth. 

a  =  6,378,137.0  m,  b  =  6,356,752.3  m.World  Geodetic 
System  of  1984.  Within  accuracy  of  MapTool 
program,  same  as  Geodetic  Reference  System  (GRS) 
of  1980. 

a  =  6,378,135  m,  b  =  6,356,750.5  m.  World  Geodetic 
System  of  1972. 

a  =  6,378,388.0  m,  b  =  6356911.9  m.  International 
Union  of  Geodesy  and  Geophysics  of  1924.  Also 
known  as  Hayford  ellipsoid. . 
a  =  6,378,249.1  m.  b  =  6,356,514.9  m. 
a  =  6,378,206.4  m.  b  =  6,356,583.8  m. 


False  Easting: 
False  Northing: 
Central  Meridian: 

Base  Latitude: 
Std.  Parallel  #1: 
Std  Parallel  #2: 
Central  Scale  Factor: 

UTM  Zone: 


See  Appendix  A,  Map  Projections,  for  a  complete 
description  of  these  parameters. 


[Apply]  Button 


[Reset]  Button 
[Save  as  default]  Button 


Selecting  this  button  applies  the  values  currently 
being  displayed  to  the  map  area.  Geodetic  values 
will  be  reformatted  into  whole  degrees  with  decimal 
minutes. 

Selecting  this  button  resets  the  fields  in  this  display 
to  the  value  currently  in  use. 

Selecting  this  button  saves  the  values  currently  in 
use  to  a  user  initialization  file.  This  file  will  be  read 
the  next  time  the  MapTool  program  is  started,  or 
when  a  New  map  is  selected. 
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5.4.4  Graticule... 

The  Grar  icr.le...  properties  menu  item  is  used  to  select  properties  that  control  the 
graticule  elements  of  the  map.  Graticule  elements  refer  to  the  graphical  elements  that  annotate  a 
chart.  For  example,  the  series  of  latitude  and  longitude  reference  lines  inside  the  chart  are 
graticule  elements.  When  3:  .v  is  selected,  the .r  :  .  :  c 

pop-up  window  is  displaced: 


Map  Tool:  Graticule  Properties 


Graticule  Element: 


Element  Visible? 
Degree  Interval:  0 

elv  hr  v:  03 


-O'  l 


Size: 

Color; 

?  fit  i.y  i  F*  . 

Line  Style: 


sriioi 


Figure  5-8.  MapToo'  Graticule  Properties 


1  he  " Km:. Too  I  :  G ::  at  i c::l~  -  r rt  i  -:-e  "  pop-up  window  is  organized  into  two 
panels.  The  upper  panel  is  used  to  select,  from,  a  menu  list,  which  graticule  element  to  modify. 
The  lower  panel  shows  various  element  attributes  —  only  those  attributes  that  are  needed  for  a 
particular  element  are  enabled.  For  example,  when  the  graticule  element  :.  e  ■■■:.  .r.  Linos  is 
selected,  the  attribute  Font  Sr  v!  -/•  is  disabled. 


The  following  are  available  graticule  elements: 


A  border  rectangle  that  encompasses  the  map  area. 
All  map  drawing  of  data  is  done  inside  the  bounding 
box. 

A  series  of  lines  corresponding  to  projected  meters 
in  cartesian  coordinates  for  the  map  area.  Lines  are 
drawn  in  both  the  X  and  Y  direction. 

Labels  corresponding  to  projected  meters  in 
cartesian  coordinates  for  tire  map  area.  Labels  are 
drawn  whore  meter  lines  would  intersect  the  map 
border,  on  the  inside  of  the  map  area. 
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Meter  Markers : 


Lat-Lon  Lines : 


Lat-Lon  Labels : 


Lat-Lon  Ticks : 


Markers  (plus  sign)  drawn  at  the  intersection  of 
lines  corresponding  to  projected  meters  in  cartesian 
coordinates  for  the  map  area. 

A  series  of  lines  corresponding  to  geodetic 
coordinates  for  the  map  area.  Lines  are  drawn  at 
both  constant  latitude  and  longitude. 

Labels  corresponding  to  geodetic  coordinates  for 
the  map  area.  Labels  are  drawn  where  the  lat-lon 
lines  would  intersect  the  map  border,  on  the  outside 
of  the  map  area. 

Short  lines  drawn  where  lat-lon  lines  would 
intersect  the  map  border,  on  the  inside  of  the  map 
area. 


Like  many  other  property  pop-up  windows,  the  following  buttons  are  available  to  modify 
parameters: 


[Apply] 

Button 

When  selected,  values  currently  being  displayed  in 
entry  fields  become  the  current  values  for  the  map. 

[RESET] 

Button 

When  selected,  the  values  currently  being  used  for 
the  map  replace  the  values  currently  being 
displayed  in  the  entry  fields. 

[Save  as  default] 

Button 

When  selected,  graticule  element  information  is 
written  to  a  user  initialization  file,  and  will  be 
loaded  and  used  the  next  time  the  MapTool  program 
is  started,  or  when  a  New  map  is  selected. 

The  lower  panel  displays  the  attributes  available  for  each  element.  The  available 
attributes  are: 


Element  Visible? 


Degree  Interval: 


Meter  Interval: 


If  [No  ]  is  selected,  then  the  selected  graticule 
element  will  not  be  displayed.  If  [  Yes  ]  is  selected, 
then  the  element  is  displayed  with  the  attributes 
shown. 

For  graticule  elements  that  occur  at  geodetic 
intervals,  this  value  is  enabled.  Enter  a  value  in 
either  decimal  degrees,  or  whole  degrees  and 
minutes. 

For  graticule  elements  that  occur  at  projected, 
cartesian  coordinate  intervals,  this  value  is  enabled. 
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\  alues  are  entered  in  meters. 

Specifies  the  si/e  of  the  selected  graticule  element. 
Allowable  selections  are: 

Thinnest  line.  Smallest  si/e  character. 

Normal  line.  Normal  size  character. 

Wider  line.  Larger  si/e  character. 

\\  iciest  line.  Largest  si/e  character. 

Ihe  actual,  displaced  or  printed  "size'  ot  various 
elements  is  dependant  on  the  output  device. 

Specifies  the  color  of  the  selected  graticule  element. 
Allowable  selections  are: 

Specifies  the  style  ot  the  characters  to  be  used  tor  the 
selected  graticule  element.  Allowable  selections  are: 
A  regular,  serif  font  is  used. 

An  italic,  serif  font  is  used. 

A  bold,  serif  font  is  used 

Ait  italic,  bold,  serif  font  is  used. 

Note  that  the  actual  font  selected  is  dependant  on 
the  output  device. 

Specifies  the  style  of  line  to  be  used  for  the  selected 
graticule  element.  Allowable  selections  are: 

A  solid  line  is  used. 

A  dashed  line  is  used. 

A  dotted  line  is  used. 

A  line  with  alternating  dashes  and  dots  is  used. 


The  following  figure  (Figure  r>-°)  shows  a  sample  chart,  with  all  of  the  possible  graticule 
elements  being  displayed: 
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- 
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2960000 

2960000- 

- 

© 

§ 

1  '■Nl 

1 

47  30 


27  00 


26  30 


©  Bounding  Box 

©  Lat-Lon  Lines 

©  Meter  Lines 

©  Lat-Lon  Labels 

©  Meter  Labels 

0  Lat-Lon  Ticks 

©  Meter  Markers 

©  Hardcopy  Label 

Figure  5-9.  Sample  Chart  with  All  Graticule  Elements  Shown 

5.4.5  Data  Display 

The  Data  Display  is  a  menu  that  leads  to  individual  menu  items  that  control  the  display 
characteristics  for  each  type  of  data  supported  by  the  MapTool  program.  For  each  data  type,  it  is 
possible  to  modify  the  default  properties  —  those  that  are  used  when  data  is  first  imported  —  and 
also  to  modify  the  display  properties  of  previously  imported  data.  Note  that  different  sets  of  data 
of  the  same  type  can  be  displayed  differently.  For  example,  one  set  of  navigation  data  may  be 
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Draw  Connecting  Lines  Between 

Data  Points  When  checked,  a  straight  line  will  be  drawn  between 
successive  navigation  data  points.  Lines  will  be 
clipped  inside  the  map  area.  If  not  selected,  no  line  is 
drawn. 

Interpolate  Between  Data 
Points  for  Ticks  &  Labels 

at  Even  Time  When  checked,  the  position  of  ticks  and  labels  are 
interpolated  from  the  navigation  data  such  that  they 
are  drawn  exactly  at  the  intervals  specified,  even  if 
the  frequency  of  data  is  different.  If  not  selected,  the 
ticks  and  labels  will  only  be  displayed  at  actual  data 
points,  and  intervals  will  indicate  the  minimum 
time  spacing  between  points. 

For  example,  consider  navigation  collected  at  15 
second  intervals  (at  :00,  :15,  :30,  :45).  If  this  setting  is 
selected,  and  the  tick  interval  is  set  to  20  seconds, 
then  the  actual  data  point  at  :00  will  have  a  tick.  The 
location  of  the  next  tick,  at  :20,  will  be  interpolated 
between  the  data  points  at  :15  and  :30,  the  next 
between  :30  and  :45.  If  this  setting  is  not  selected, 
and  the  tick  interval  is  still  20  seconds,  while  the  first 
tick  is  drawn  at  the  data  point  at  :00,  the  next  tick 
will  be  drawn  at  the  data  point  at  :30. 

Tick  Marks,  Tick  marks  are  small  lines  drawn  at  a  location  along 

the  navigation  trackhne.  When  checked,  tick  marks 
will  be  drawn.  When  not  selected,  no  tick  marks  are 
drawn. 

Interval  (hh:mm:ss)  :  The  interval  to  draw  tick  marks.  Time  values,  in 

hours,  minutes,  and  seconds,  are  entered  separated 
by  colons. 

Side :  When  [Port]  is  selected,  the  tick  mark  is  drawn  on 

the  port  (or  left)  side  of  the  trackline.  When  [Stbd] 
is  selected,  tick  marks  are  drawn  on  the  starboard 
(or  right)  side.  If  both  [Port]  and  [Stbd]  are 
selected,  then  tick  mark  is  drawn  across  the 
trackline.  If  neither  selected,  then  no  tick  mark  is 
drawn. 

Time  Labels,  Time  labels  may  be  drawn  to  indicate  the  time  of  a 

navigation  data  point.  The  hour,  minute,  and, 
optionally,  the  second  of  the  data  point  is  drawn. 

Interval  (hh:mm:ss):  The  interval  to  draw  time  labels.  Time  values,  in 
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hours,  minutes,  and  seconds,  are  entered  separated 
'ey  colons.  It  the  interval  selected  it  less  than  one 
minute,  then  time  labels  will  be  displayed  with  the 
seconds  field:  otherwise,  only  hours  and  minutes 
are  displaced. 

V.  hen  [r  :  re  ]  is  selected,  the  time  label  is  drawn  on 
the  port  tor  left »  side  of  the  trackline.  When  [y  yp.il 
is  selected,  the  time  label  is  drawn  on  the  starboard 
tor  right)  side.  One  and  only  one  side  may  be 
selected 


Dat  <: 


Labe  ! 


L a b e  1  Or  i e n t  a r  i c, r. : 

P  e  r  p  e  n  dicrular  r. :  7  =■ ; :  > 


c:. 


l.i i no  Thick  most:  : 


Date  labels  may  be  drawn  to  indicate  the  date  of  a 
navigation  data  point.  The  year  and  day  of  year  are 
drawn. 

f  he  interval  to  draw  date  labels.  Time  values,  in 
hours,  minutes,  and  seconds,  are  entered  separated 
bv  colons. 

^  hen  [r  ■  ■  1  is  selected,  the  date  label  is  drawn  on 
the  port  (or  left  >  side  of  the  trackline.  When  I  Job  i] 
is  selected,  the  date  label  is  drawn  on  the  starboard 
•or  right)  side.  One  and  only  one  side  may  be 
selectee!. 

delects  the  size  of  labels  to  be  drawn.  Values  range 
from  V:  .'.  V  to  : .  :. 

Determines  the  angle  of  ticks  and  labels.  Possible 
values  are: 

I  icks  and  labels  are  oriented  perpendicular  to 
consecutive  navigation  data  points. 

;  icks  and  labels  are  oriented  horizontally,  such  that 
labels  appear  in  a  normal  direction  on  the  screen. 

1  icks  and  labels  are  oriented  vertically,  such  that 
labels  appear  "sideways"  on  the  screen. 

Selects  the  color  of  lines,  ticks,  and  labels.  Possible 
color  values  are: 


Selects  the  thickness  of  the  trackline,  if  drawn. 
Values  range  from  ".mm:  I."  to  "Lxr.  ra-Larqe 


Rags  5-18 
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[APPLY] 


[Reset] 


[Save  as  default] 


Button 


Button 


Button 


When  selected,  values  currently  being  displayed  in 
entry  fields  become  the  current  values  for  the 
navigation  display. 

When  selected,  the  values  currently  being  used  for 
navigation  display  replace  the  values  currently 
being  displayed  in  the  entry  fields. 

When  selected,  values  currently  in  entry  fields  are 
written  to  a  user  initialization  file,  and  will  be 
loaded  and  used  as  the  default  navigation  data 
display  properties  the  next  time  the  MapTool 
program  is  started,  or  when  a  New  map  is  selected. 


The  following  figure  (Figure  5-11)  shows  a  typical  navigation  trackline,  with  graphical 
elements  labelled: 


46  30  46  00 


©  -  Date  Labels  on  Port  Side 
Figure  5-1 1 .  Sample  Navigation  Trackline 


5.4.5.2  Multibeam  Data... 
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The  following  are  the  available  grid  data  display  properties: 

Data  to  Use  for  Display:  Selects  which  data  from  the  grid  is  to  be  used  for 

display.  Will  only  affect  gridded  data  which  has 
been  created  such  that  interpolated  grid  points  are 
properly  flagged.  Possible  settings  are: 

Use  All  Values,  Real 

and  Interpolated:  All  values  are  used.  Values  that  are  interpolated  are 

scaled  to  the  proper  range. 

Use  Only  Real  Values:  Only  values  that  are  flagged  as  "real"  are  used. 

Generally,  these  are  grid  points  that  contained  at 
least  one  original  data  point  prior  to  gridding. 

Use  Interpolated  Values 

within  Range:  All  real  values  are  used.  In  addition,  interpolated 

values  will  be  used  if  a  grid  point  with  a  "real"  data 
point  is  within  a  specified  range  of  the  interpolated 
grid  point. 

Range  :  Specifies  the  number  of  grid  cells  to  search  for  "real" 

data  points.  Allowable  values  range  from  1  to  25. 

Draw  Outline  of 

Grid  Area:  Specifies  whether  to  draw  a  solid  color  rectangle 

representing  the  location  of  the  grid  data.  This 
setting  is  useful  when  locating  chart  boundaries 
relative  to  previously  import  grid  data,  since  the 
outline  can  be  drawn  very  quickly. 

Custom  Color  Scale  File:  When  checked,  allows  for  specifying  the  name  of  a 

custom  color  scale  file  to  use  for  color  images  and 
color  filled  contours.  When  not  checked,  the  default 
color  scale  is  used. 

[ browse  .  .  .  ]  Button  When  this  button  is  selected,  a  file  popup  window 

appears  which  allows  for  the  selection  of  a  custom 
color  scale  file. 

Draw  As  Color  Image:  Draw  the  selected  grid  data  as  an  image,  usually 

using  a  single  color  (general  grey-scale)  to  denote 
intensity.  An  image  is  drawn  by  filling  each  grid  cell 
with  a  single  color  based  on  its  value. 

Interval :  Selects  the  interval  for  image  intensity  changes.  The 

range  of  values  for  which  the  interval  is  used  is 
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taken  from  the  attributes  of  the  grid  data. 

Draw  color  filled  contours  representing  the  selected 
grid  data.  Colors  are  taken  from  the  currently  active 
color  table. 

Selects  the  interval  for  color  changes.  The  range  of 
values  for  which  the  interval  is  used  is  taken  from 
the  attributes  of  the  grid  data. 

Specifies  the  amount  of  smoothing  desired. 
Smoothing  is  accomplished  bv  generating  extra 
node  points  inside  each  grid  cell.  Allowable  values 
range  from  0  (no  extra  smoothing)  to  4  (maximum 
smoothing). 


Draw  isolines  representing  the  selected  grid  data.  A 
variety  of  drawing  options  are  available: 

Selects  the  interval  tor  drawing  isolines. 

Selects  the  interval  for  labelling  isolines  with  their 
value.  Must  be  a  multiple  of  the  Lima  IiKervai. 
Regardless  of  line  color,  labels  are  always  drawn  in 
k  ark.  If  this  attribute  is  set  to  0,  then  isolines  will 
not  be  labelled. 

Selects  the  interval  for  drawing  thick  isolines.  These 
can  be  used  to  highlight  certain  isolines.  Must  be  a 
multiple  of  the  :  lure rv  A  .  If  this  attribute  is 

set  to  (),  then  no  thick  isolines  will  be  displayed, 
specifies  the  amount  of  smoothing  desired. 
Smoothing  is  accomplished  bv  generating  extra 
node  points  inside  each  grid  cell.  Allowable  values 
range  from  0  (no  extra  smoothing)  to  4  (maximum 
smoothing). 

Specifies  the  color  of  the  isolines  to  be  drawn. 
Allowable  fixed  colors  are: 

In  addition,  the  1  :  1  _  r  attribute  can  be  set  to  an 
-rrigvsi,  so  that  the  color  of  isolines  cycles 
through  a  set  of  colors.  This  option  is  normally  only 
used  when  generating  hardcopy  to  pen  plotter 
devices. 

Specifies  the  interval  for  changing  isoline  colors, 
t  he  color  sequence  used  is  fixed:  Black,  Red, 
Breen  and  Bi  r  r.  Must  be  a  multiple  of  the  line 
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I 

I 

[APPLY]  Button 

I 

[RESET]  Button 

I 

I 


When  selected,  values  currently  being  displayed  in 
entry  fields  become  the  current  values  for  the 
gridded  data  display. 

When  selected,  the  values  currently  being  used  for 
gridded  data  display  replace  the  values  currently 
being  displayed  in  the  entry  fields. 

When  selected,  values  currently  in  entry  fields  are 
written  to  a  user  initialization  file,  and  will  be 
loaded  and  used  as  the  default  grid  data  display 
properties  the  next  time  the  MapTool  program  is 
started,  or  when  a  New  map  is  selected. 


[Save  as  Default]  Button 


I 

I 


The  following  figure  (Figure  5-13)  shows  a  sample  Color  Image  display.  In  this  sample,  a 
monochromatic,  custom  color  scale  has  been  applied. 


I 

I 
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1  he  follow  ing  figuie  (1  iguie  n-141  snows  an  example  of  C  olor  Filled  C  ontours.  In  this 
example,  the  Color  Interval  has  been  selected  as  2hi 


46  30 


46  00 


45  3C 


45  00 


45  30 


45  00 


26  00|-j . 

46  30 


46  00 


26  30 


26  00 


Figure  5-14.  Sample  Color  Filed  Contours. 


The  following  figure  (Figure  5-1?)  shows  an  example  of  ;  ; 's'  i».-.  s  In  this 
example,  the  Line  I  wierval  is  ..  ..  the  1  ei  esvel  is  1  1  1  L,  and  the  Th  Let: 

Interval  is  1000. 
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Figure  5-15.  Sample  Contour  Isoline  Display 


5.4.5.4  Alongtrack  Data 

The  Alongtrack  Data...  menu  item  is  used  to  select  and  modify  the  properties  for  the 
display  of  along  track  data.  Alongtrack  data  consists  of  a  series  of  scalar  values  at  a  geodetic 
position.  When  the  menu  item  is  selected,  the  "MapTool :  Along  Track  Display 
Properties"  pop-up  window  is  displayed: 
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MapTnni:  Along  Track  Display  Properties 

Y 

Limit  Values  to  be  Displayed 

Min: 

T.220:i.._ . 

Max: 

Y 

Draw  Line  Between  Values 

Color: 

-  R;.?ck 

Y 

Draw  Symbol  for  Each  Value 

Color: 

B I  k 

Size: 

y  Small 

SymbD  1: 

~  jTl 

Y 

Display  Actual  Value 

Color: 

Black 

Size: 

M  edit:  rn 

Orientation: 

Perpend 

Y 

Display  Values  Graphically 

Color: 

B  :ack 

Size:  y.  Medium 
"Zero"  Reference  Value:  0.0000 

Orientation:  Constant  Azimuth... 

Azimuth,  Compass  Degrees:  0 

Display  Style:  Aw, 

mV;  Reset  Save  as  Default 

Default  Properties 

Figure  5-16.  MapToci  Along  Track  Display  Properties 


The  display  properties  shown  in  the  pop-up  window  are  either  the  Default  Properties, 
which  are  used  when  new  aiongtrack  data  is  imported,  or  are  the  properties  associated  with  ’ 
previously  imported  aiongtrack  data.  In  the  former  case,  the  left  footer  will  indicate  Default: 
Proport  lew.  In  the  later  case,  the  left  footer  will  show  the  name  of  the  aiongtrack  file  associated 
with  the  display  properties.  To  select  a  previously  imported  aiongtrack  file's  display  properties, 
first  select  the  data  file  from  the  "two  T_  ;  1  :  :  .-  .  Du:wu.  :  y "  pop-up  window. 

T  he  following  are  the  available  aiongtrack  data  display  properties: 

Limit  Values:  u ; 

Di&p-cjy-ss.  \\  hen  selected,  only  those  data  points  with  scalar 

values  within  the  specified  range  are  displayed. 

W  hen  not  selected,  all  data  points  are  used. 

1  he  minimum  scalar  value  to  be  used. 
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Max:  The  maximum  scalar  value  to  be  used. 

Draw  Line 

Between  Values:  When  selected,  a  solid  line  is  drawn  that  connects 

consecutive  points  in  geographic  position.  When 
not  selected,  connecting  lines  are  not  drawn. 

Color:  Specifies  the  color  of  the  connecting  line  between 

consecutive  points.  Allowable  colors  are: 

Black  Blue  Red  Magenta 

Green  Cyan  Yellow  White 

When  selected,  a  marker  symbol  is  drawn  at  the 
location  of  each  scalar  value.  When  not  selected,  no 
marker  is  drawn.  If  selected,  the  follow  options  are 
available: 

Specifies  the  color  of  the  marker.  Allowable  colors 
are: 

Black  Blue  Red  Magenta 

Green  Cyan  Yellow  White 

Specifies  the  size  of  the  marker.  Four  "fixed"  sizes 
are  available: 

Small  Medium  Large  Extra-Large 
In  addition,  a  size  of  "Proportional  to  Value" 
is  available.  In  this  case,  the  size  of  the  marker  at  the 
minimum  scalar  value  will  be  "Small,"  and  the  size 
at  the  maximum  scalar  value  will  be  "Extra-Large." 
Other  markers  will  be  scaled  according  to  their 
scalar  value. 

Specifies  the  marker  to  be  displayed.  Twelve 
different  marker  styles  are  available. 

Display  Actual  Value:  When  selected,  the  numeric  representation  of  the 

scalar  value  is  displayed.  The  precision  at  which  the 
value  is  displayed  is  dependant  on  the  range  of 
available  data. 

Color :  Specifies  the  color  of  the  value  string.  Allowable 

colors  are: 

Black  Blue  Red  Magenta 

Green  Cyan  Yellow  White 

Size:  Specifies  the  size  of  the  value  string.  Four  "fixed" 

sizes  are  available: 

Small  Medium  Large  Extra-Large 
Orientation:  Determines  the  angle  of  value  string.  Possible 


Draw  Symbol  for 
Each  Value: 


Color : 


Size : 


Symbol: 
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Pe 


Ij  l  : 


Gi  a 


"Zero"  Robe  rev 


Pe  L'penci 


A  z  i  m  u  t  h ,  C  c  nip  a  a  ?  Lera  e  .  : 


Fill  e 
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\  allies  are: 

\  alue  string  is  oriented  perpendicular  to  consecutive 
data  points. 

\  alue  string  is  oriented  horizontally,  such  that 
labels  appear  in  a  normal  direction  on  the  screen. 
Value  string  is  oriented  verticalK ,  such  that  labels 
appear  "sideways"  on  the  screen. 


M  hen  selected,  allows  for  displacing  the  magnitude 
of  the  scalar  value  in  a  graphical  form.  Allowable 
options  for  graphical  display: 


Specifies  the  color  of  the  graphical  display. 
Allowable  colors  are: 


Specifies  the  overall  scale  of  the  graphical  display, 
hour  "fixed’  scales  are  available: 

Specifies  the  scalar  value  of  the  origin  of  the 
graphical  display.  The  origin  is  defined  as  base  line 
that  connects  consecutive  points.  For  example,  to 
produce  a  graphic  display  distributed  on  both 
'  sides'  of  the  base  line,  the  "d-.- r ,  "  Re  fe  rone-  • 

A  .:•  •  attribute  should  beset  to  (Min+Max)/2. 

Specifies  the  angle  for  the  graphical  display. 
Allowable  options  are: 

The  amplitude  of  the  graphical  display  will  be 
drawn  perpendicular  to  the  angle  between 
consecutive  data  points. 

The  amplitude  of  the  graphical  display  will  be 
drawn  at  a  constant  azimuth. 


Specifies  the  azimuth,  in  whole  degrees,  for  the 
amplitude  of  the  graphical  display. 


Specifies  the  type  of  graphic  display  to  be  generated. 
I  hree  types  of  display  are  supported: 

A  solid  line  is  used  to  connect  consecutive,  scaled 
values. 

A  solid  line  is  used  to  connect  consecutive,  scaled 
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values.  In  addition,  the  area  between  the  solid  line 
and  the  base  line  is  filled  with  a  solid  color. 

Vector  Style  A  solid  vector  line  is  drawn  for  each  point,  from  the 
location  of  the  point,  in  the  angle  specified,  and 
scaled  to  the  scalar  value  for  the  point. 


[Apply]  Button 


[Reset]  Button 


[Save  as  Default]  Button 


When  selected,  values  currently  being  displayed  in 
entry  fields  become  the  current  values  for  the  along 
track  data  display. 

When  selected,  the  values  currently  being  used  for 
along  track  data  display  replace  the  values  currently 
being  displayed  in  the  entry  fields. 

When  selected,  values  currently  in  entry  fields  are 
written  to  a  user  initialization  file,  and  will  be 
loaded  and  used  as  the  default  along  track  data 
display  properties  the  next  time  the  MapTool 
program  is  started,  or  when  a  New  map  is  selected. 


The  following  figure  (Figure  5-1 7)  shows  samples  of  various  combinations  of  along  track 
display  parameters: 
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-  Symbol  and  Actual  Value  displaced 

-  Symbol  displayed,  with  Si/e  parameter  set  to  "Proportional  to  Value," 

-  Graphical  Display,  with  Display  St  vie  parameter  set  to  "Wiggle  Style." 

-  Graphical  Display,  with  Display  Style  parameter  set  to  "Filled-Wiggle  Style. 

-  Graphical  Display,  with  Display  Style  parameter  set  to  "Vector  Style,"  and 

Orientation  parameter  set  to  "Vertical." 


-  Graphical  Display,  with  Disph 
and  "Zero  Refernce  Value'  pai 


iy  Style  parameter  set  to  "Filled-Wiggle  Style,' 
■ameter  set  less  than  minimum  value  ot  data. 


Figure  5-1  7.  Sample  A:ong  Track  Displays 


5. 4. 5. 5  Sidescan  Data 


The 


me> non 


5. 4.5. 6  Image  Data 

The  Image  Dar.a...  mem-  item  ;/  net  .mm.'.W 
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Section  6  —  Data  Files 


MapTool  currently  supports  importing  a  number  of  different  data  files  and  types.  In  order 
to  lessen  the  need  to  repeatedly  convert  potentially  large  data  files  from  one  format  to  another, 
the  data  handlmg  portion  of  the  MapTool  program  is  built  upon  the  concept  of  separate  data 
attributes  and  data  records.  Data  attributes  are  elements  which  describe  the  data  —  in  many  other 
data  systems,  this  attribute  information  might  be  stored  as  header  records  embedded  along  with 
data  records  in  a  single  data  file.  For  the  MapTool  program,  data  attributes  are  always  stored  as 
plain,  ASCII  text  files,  using  a  consistent  <attribute-name>:<value>  notation.  Attributes 
may  be  listed  in  any  order,  and  unknown  attributes  may  be  omitted.  In  addition,  attributes  may 
be  listed  in  a  separate  file  from  data  records,  or  may  be  "pre-pended"  to  the  beginning  of  the 
actual  data  record  file. 

The  format  of  the  actual  data  records  is  described  via  the  data  attribute  mechanism.  In  this 
way,  a  variety  of  data  record  formats  can  be  supported  in  their  native  mode.  The  data  records 
may  be  in  separate  files  from  the  attribute  information.  In  this  manner,  it  may  not  be  necessary  to 
reformat  a  data  record  file  prior  to  importing.  For  example,  some  data  types  support  reading 
values  directly  from  MGD-77  type  data  record  files.  A  single  set  of  attributes  may  also  describe  a 
collection  of  data  files  that  should  be  operated  on  as  a  group.  Also,  a  single  data  record  file  may 
be  described  by  multiple  sets  of  attributes,  so  that  different  information  can  be  conveniently 
extracted. 


6.1  Navigation  Data 

Navigation  data  is  defined  a  series  of  time- dependent  positions,  usually  in  sequential 
order.  Navigation  data  be  be  stored  in  a  separate  file  consisting  of  only  time-position  records,  or 
navigation  information  can  be  extracted  from  files  that  contain  multiple,  time-dependant  scalar 
or  vector  information.  For  a  typical  navigation  attribute  file,  see  Appendix  B. 

The  currently  defined  navigation  attributes  consist  of: 

Nav .  version :  Must  be  the  first  line  of  the  attribute  file.  Set  to  "vl.O" . 

Nav .  latMinimum :  Tire  minimum  (southern)  geodetic  latitude  limit  of  data. 

Values  smaller  than  this  value  will  not  be  used.  Value  is 
signed,  decimal  degrees. 

Nav .  lonMinimum :  The  minimum  (western)  geodetic  longitude  limit  of  data. 

Values  smaller  than  this  value  will  not  be  used.  Value  is 
signed,  decimal  degrees. 
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Tiie  maximum  i northern)  geodetic  latitude  limit  ot  data. 
Values  larger  than  this  value  will  not  be  used.  Value  is 
signed,  decimal  degrees. 

The  maximum  (eastern'  geodetic  longitude  limit  of  data. 

\  allies  smaller  than  this  value  will  not  be  used.  Value  is 
signed,  decimal  degrees 

I  he  minimum  time  of  data.  Values  smaller  than  this  value 
will  not  be  used.  \  nine  is  expressed  as  ear/Month/Day 
Hour:Minute:5econd’ . 

The  maximum  time  of  data.  Values  larger  than  this  value 
will  not  be  used.  \  nine  is  expressed  as  ear/Month/Day 
H  ou  r:\lin  ute:Second". 


The  format  type  of  the  data  records.  \  alue  is  expressed  as 
ASCII  character  string.  Currently  supported  format  tvpes, 
with  string,  are: 

ASC  11  records  consist  of  three  floating  point  numbers, 
separated  by  whitespace,  terminated  bv  a  newline.  First 
value  is  number  of  seconds  since  1  /  1  /  1970.  Second  value  is 
signed  decimal  degrees  of  latitude.  1  bird  value  is  signed 
decimal  degree  of  longitude. 

Binary  records  consist  of  continuous  binarv  representations 
of  time  and  position.  1  he  first  value  is  time,  expressed  as  a 
Unix  .  L  structure.  The  second  value  is  latitude, 

expressed  as  a  :::  ie,  signed  decimal  degi  'ees.  1  he  third 
value  is  longitude,  also  expressed  as  a  ;•  .  1  ■  ■,  signed 

decimal  degrees. 

TXS  records  consist  ot  multiple  attributes  along  with  time 
dependent  positions.  At  present,  I’NS  files  are  defined, 
maintained,  and  used  bv  DSL. 

Ashtech  records  consist  of  multiple  attributes  along  with 
time  dependent  positions.  These  types  of  files  are  generated 
by  the  Ashtech  Cl’S  processing  software. 

MC.D, ,  records  consist  of  multifile  attributes  along  with 
time  dependent  positions. 

PXS.Xh  records  consist  of  multiple  attributes  along  with 
time  dependent  positions.  Position  data,  however,  is 
expressed  in  Cartesian  coordinates  (XA  )  rather  than 
geodetic.  At  present.  PXS  files  are  defined,  maintained,  and 
used  bv  DSL. 

These  formats  are  defined  and  maintained  bv  the  University 
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of  Rhode  Island,  Scripps  Institute  of  Oceanography,  and 
Lamont-Doherty  Earth  Observatory.  These  formats  arc  not 
supported  at  this  time. 

Nav .  location:  The  location  of  data  records  relative  to  the  file  containing 

navigation  attributes.  There  are  three  possible  values  for 
this  attribute: 

Internal  Data  records  are  located  within  the  same  file  as  attributes. 
Data  records  begin  after  any  header  defined  by  the 
Nav . headerLength  attribute. 

External  Data  records  are  located  in  a  different  file  than  the 

attributes.  Data  records  begin  after  any  header  defined  by 

Nav . headerLength. 

List  Data  records  are  located  in  multiple  files  outside  of  the 

attribute  file.  In  this  case,  the  full  file  and  path  name  of  each 
data  file  are  located  after  the  navigation  attributes.  For  each 
data  file,  data  records  begin  after  any  header  defined  by 

Nav . headerLength. 

Nav .  f  ileName:  The  file  name  of  the  file  containing  data  records.  This 

attribute  is  only  needed  when  Nav .  location  is  set  to 
External. 

Nav .  pathName  :  The  path,  or  directory,  name  of  the  file  containing  data 

records.  This  attribute  is  only  needed  when  Nav. location 
is  set  to  External. 

Nav .  utmZone  :  The  UTM  zone  number  used  in  constructing  Cartesian 

coordinates  (X,Y)  of  data  in  PNSXY  format.  This  is 
expressed  as  an  integer  number,  from  1  to  60. 

Nav .  numPoints  :  The  maximum  number  of  data  records  to  be  read  by  this  set 

of  attributes.  If  Nav.  location  is  set  to  List,  then  this 
value  should  be  the  sum  of  data  records  in  all  listed  files. 
When  unsure  of  total  number  of  records,  estimate  number 
on  the  high  side  to  insure  that  all  values  will  be  read. 

Nav .  headerLength  :  The  number  of  bytes  prior  to  the  beginning  of  the  first  data 

record.  This  is  expressed  as  an  integer  number.  If  no  header 
present,  set  value  to  0.  When  the  attribute  Nav .  format  is 
set  to  MGD77,  this  value  is  the  number  of  lines  to  skip  prior 
to  reading  data.  "Full"  MGD77  file  contain  24  lines.  Some 
files,  however,  contain  0  lines. 
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6.2  Multibeam  Data 


Mullibcmn  data  /s  not  tupvrU’J  ‘/::s 


6.3  Gridded  Data 

Ci ridded  data  is  defined  as  a  two-dimensional  arrav  of  scalar  values,  spaced  at  a  uniform 
distance  and  located  at  a  geographic  position. 


I  he  currently  defined  grid  attributes  are: 


Cird  .  ver  si  on  : 


1  he  version  of  the  grid  attribute  file.  Currently  set  to 


C  haracter  string  which  denotes  the  name  of  the 
program  that  produced  the  gridded  data. 

String  which  denotes  the  date  and  time  the  gridded 
data  was  created. 

String  which  denotes  the  general  type  or  class  of  the 
gridded  data.  Examples  are  "b»:hy:::-crv"  or 


Grd  .  nanm  :  String  specifying  a  name  of  the  gridded  data.  May 

be  used  for  labels,  legends,  etc. 

Oiid  .  si  our  cm  :  Specifies  the  source  of  the  gridded  data,  or  the  data 

that  was  used  to  construct  the  grid. 

Cird  .  source-Tirr.-: :  Specifies  the  date  and  time  that  the  source  of  the 

data  was  created. 


Lser-specifiecl  comments  about  the  gridded  data. 

Specifies  the  general  type  or  class  of  the  sensor  used 
m  acquiring  the  source  data  for  the  grid.  Examples 
are  "c  -  :. i "  and  -  ::  ,c  •  .  -r." 

Specifies  the  name  of  the  sensor  used  in  acquiring 
the  source  data  for  the  grid. 
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Grd  .  sensorConf  igFileName  :  Specifies  the  name  of  a  file  that  contains 

configuration  information  about  the  sensor  used  in 
acquiring  the  source  data  for  the  grid.  Such 
information  might  consist  of  calibrations,  switch 
settings,  and  so  forth. 

Grd .  sensorConf  igFilePath :  Specifies  the  path  or  directory  name  of  the  sensor 

configuration  file. 

Grd .  unit :  Specifies  the  name  of  the  units  of  the  gridded  data. 

Grd. precision:  Numeric  value  specifying  the  precision  of  the 

gridded  data,  express  in  the  number  of  bits.  Simple 
raster  data  typical  contains  8  bits  of  precsion,  and 
single  precision  floating  point  data  contains  6  bits. 

Grd .  minimumValue  :  Numeric  value  specifying  the  smallest  allowable 

value  in  the  domain  of  data.  Values  less  than  this 
value  are  not  used.  Compare  with 

Grd . zMinimumValueFound. 

Grd .  maximumValue  :  Numeric  value  specifying  the  largest  allowable 

value  in  the  domain  of  data.  Values  greater  than  this 
value  are  not  used.  Compare  with 
Grd . zMaximumValueFound. 

Grd.nullValue:  Numeric  value  specifying  the  value  given  for 

missing  values  in  the  grid.  Values  equal  to  this  value 
not  used. 

Grd.  specialValue  :  Numeric  value  specifying  a  value  that  has  "special" 

meaning.  Values  that  are  "special"  are  represented 
in  the  grid  as  being  outside  of  the  domain  of  the 
data,  but  not  null  values.  "Special"  values  may  be 
converted  to  proper  data  by  dividing  by  this 
attribute  value.  Note  that  not  all  software  supports 
"special"  values. 

Grd .  nullValueFound :  Logical  flag  ("True"  or  "False")  indicating  whether 

a  null  value  is  present  in  the  grid. 

Grd .  specialValueFound :  Logical  flag  ("True"  or  "False")  indicating  whether 

a  special  value  is  present  in  the  grid. 
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Gi'd  .  >:Mi  r:  invar.  Vr;  1  u-:-r  .  :  Numeric  value  specif  vine;  the  smallest  value  in  the  x 

domain  that  has  been  found  in  the  grid. 

Grd  .  xMaxi  nmmVadaod  .  mu:  Numeric  value  specifving  the  largest  value  in  the  \ 

domain  that  has  been  found  in  the  grid 

Grd  .  yMi n inu::::7a  1 ;; ~  :: :  Numeric  value  specifving  the  smallest  value  in  the  y 

domain  that  has  been  found  in  the  grid 


Numeric  value  specit’ving  the  largest  value  in  the  v 
domain  that  has  been  found  in  the  grid 

Numeric  value  specit’ving  the  smallest,  actual  data 
value  found  in  the  grid.  Compare  with  the  attribute 


Numeric  value  specifying  the  largest,  actual  data 
value  found  in  the  grid.  Compare  with  the  attribute 


Grd  .  pi  c  lew:,  i  or.:  y;  ■  -  :  Description  of  the  type  of  projection  used  to 

transform  from  geodetic  (lat, Ion)  reference  to  grid 
coordinates  (\,v).  Possible  values  are: 

G.i  d  .  put  j  ecu.  i  ore.  ~  ..  i ;.  ;  i  a  :  Description  of  the  ellipsoid  used  when  transforming 

geodetic  (lat, Ion'  to  grid  (\,y)  coordinates.  Possible 
values  are: 


Description  of  the  datum  used  when  transforming 
geodetic  (lat, Ion)  to  grid  (\,v)  coordinates.  Possible 
values  are: 


Numeric  value  for  the  L  I  NI  zone  number  used 
when  transforming  geodetic  (lat, Ion)  to  grid  (x  v) 
coordinates.  Possible  values  are  ::  to  ■  ::. 
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Grd .  pro  jectionFalseEast :  Numeric  value  for  False  Easting  used  when 

transforming  geodetic  (lat,lon)  to  grid  (x,y) 
coordinates. 

Grd .  pro  ject  ionFalseNorth :  Numeric  value  for  False  Northing  used  when 

transforming  geodetic  (lat,lon)  to  grid  (x,y) 
coordinates. 

Grd .  pro  jectionCentralMerid :  Numeric  value  for  the  Central  Meridian  used  when 

transforming  geodetic  (lat,lon)  to  grid  (x,y) 
coordinates. 

Grd .  pro  jectionBaseLatitude  :  Numeric  value  for  the  Base  Latitude  used  when 

transforming  geodetic  (lat,lon)  to  grid  (x,y) 
coordinates. 

Grd .  pro  jectionStdParallell :  Numeric  value  for  Standard  Parallell  #1  used  when 

transforming  geodetic  (lat,lon)  to  grid  (x,y) 
coordinates. 

Grd.projectionStdParallel2:  Numeric  value  for  Standard  Parallell  #2  used  when 

transforming  geodetic  (lat,lon)  to  grid  (x,y) 
coordinates. 

Grd .  pro  jectionCentralScale  :  Numeric  value  for  the  Central  Scale  factor  used 

when  transforming  geodetic  (lat,lon)  to  grid  (x,y) 
coordinates. 

String  specifying  the  name  of  the  units  used  for  grid 
coordinates.  Examples  are  "meters"  or  "degrees." 

String  specifying  coordinate  convention  for  the 
orientation  of  the  x,y,  and  z  axis  of  the  grid.  Two 
possible  values  are  "Right-Hand"  or  "Left-Hand." 

String  specifying  the  location  of  grid  values  relative 
to  the  grid  coordinates.  Two  possible  values  are: 

A  "Grid"  lattice  is  one  where  the  grid  values  are 
located  at  the  intersection  of  x  and  y  grid 
coordinates. 

A  "Lattice"  lattice  is  one  where  the  grid  values  are 
located  at  the  center  of  a  rectangle,  who's  borders 
are  defined  by  the  x  and  y  grid  coordinates. 


Grd. coordinateUnit : 


Grd. coordinateSense : 


Grd.coordinateLattice: 

Grid 


Lattice 
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c;  j  ci .  z.C 


Cirri  .  >: : ;  c  a  ;i 


Gird  .  y f ' : • . : : 


Ci rd  .  Sitiz 


Gi  ci .  zkc c.  nv 


Gi  ci .  : 


Gr  ci .  scr 


Grd  .  conns  r .  • :  s  ion  : 
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Numeric  value  specitving  the  value,  in  grid 
coordinates,  of  the  \  origin  of  the  gridded  data. 

Numeric  value  specitving  tire  value,  in  grid 
coordinates,  of  the  v  origin  of  the  gridded  data. 

Numeric  value  specitving  the  origin  of  the  gridded 
data  values.  This  value  will  be  added  iif'trr  any 
scaling  is  performed  (See  3 i  d  .  ::  i  a 

Numeric  value  specifying  the  scale  factor  for  grid 
coordinates  in  the  \  domain.  This  value  can  also  be 
considered  as  the  \  grid  interval. 

Numeric  value  specifying  the  scale  factor  for  grid 
coordinates  in  the  v  domain.  This  value  can  also  be 
considered  as  the  v  grid  interval. 

Numeric  value  specif)  ing  the  scale  factor  of  the 
gridded  data  value.  The  actual  data  stored  is 
multipled  by  this  value  prior  to  use. 

Numeric  value  specifying  the  angle  of  rotation  of 
the  gridded  data.  Angles  are  expressed  in  decimal 
degrees,  based  on  coordinate  sense. 

String  specifying  the  actual  format  of  the  gridded 
data  file.  Allowable  values  are: 

A  simple  raster  format.  See  ims  ;•  z  :.. ;  •.>  (  5  )  , 

A  floating  point  format,  produced  bv  some  gridding 
programs. 

A  grid  format  used  bv  the  CA11  -Series  of  programs. 
No:  cti .,/x,’':o.|.>.,c/:rc./. 

A  grid  format  used  by  the  Matlab  program.  Not 

Logical  flag  (  I  rue"  or  1  F  alse"  )  indicating  the 
row-order  of  grid  data.  When  set  to  True,  then 
row-order  is  top-down.  When  set  to  l  alse,  then 
row-order  is  bottom-up. 

String  specitving  the  name  of  the  compression 
algorithm  used  to  store  the  data. 
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Grd .  type  :  String  specifying  tire  data  type  of  each  stored  grid 

value.  Possible  values  are: 

Tiny  Short  Integer  Single 
Double  ASCII  Complex  Single 

Grd .  depth :  Numeric  value  specifying  the  number  of  bits  per 

stored  grid  value.  Typical  values  are  8,  16,  32,  and 
so  forth. 

Grd. dimension:  Numeric  value  specifying  the  number  of  individual 

values  that  make  up  a  single  grid  value. 

String  specifying  the  sequence  of  mult-dimensional 
grid  values.  Possible  values  are: 

All  values  of  a  single  dimension  are  stored 
sequentially,  followed  by  all  values  of  the  next 
dimension,  and  so  forth. 

All  values  from  all  dimensions  for  a  single  grid 
element  are  stored,  followed  by  all  values  for  the 
next  element,  and  so  forth. 

Grd .  order :  String  specifying  the  order  in  which  grid  data  is 

stored.  Possible  values  are: 

Row-Major  Values  are  stored  row  by  row. 

Column-Ma  j or  Values  are  stored  column-by-column. 

Grd.xSize:  Numeric  value  specifying  the  number  of  elements  in 

the  x  dimension  —  also  the  number  of  "columns." 

Grd.ySize:  Numeric  value  specifying  the  number  of  elements  in 

the  y  dimension  —  also  the  number  of  "rows." 

Grd .  headerLength  :  Numeric  value  specifying  the  number  of  bytes  of 

header  information  in  the  gridded  data  file.  The  first 
byte  of  actual  grid  data  is  assumed  to  be  directly 
after  any  header  information. 

Grd. location:  String  specifying  the  location  of  the  gridded  data 

described.  Possible  values  are: 

External  Gridded  data  is  contained  in  an  external  file,  not  this 
attribute  file. 

Internal  Gridded  data  is  appended  to  the  end  of  this  attribute 
file,  after  the  attribute  terminator  character  [Ctrl/L]. 


Grd . sequence : 

Sequential 

Interleaved 
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First  comes  the  header  then  the  data. 

Grd  .  dovicre!:.-!::.-: :  Character  string  specifying  the  name  of  the  physical 

device  on  which  the  gridded  data  is  physically 
stored.  Normally  only  used  when  the  device  is  not 
an  on-line  disk  medium.  For  example,  may  be  used 
to  specify  an  off-line  tape  device. 

Grd  .  vo .1  -ani-  e . ;  C  haracter  string  specifying  the  name  of  the  volume 

on  which  the  gridded  data  is  physically  stored. 
-Normally  only  used  when  the  device  is  not  an 
on-line  disk  medium.  For  example,  may  be  used  to 
specify  the  name  or  label  of  a  magnetic  tape. 

Grd  .  hi  a  or  ante  :  Character  string  specifying  the  file  name  the  gridded 

data  file,  used  when  the  near  :  a  is 


Character  string  specifying  the  path  or  directory 
name  of  the  gridded  data  file,  used  when  the 


6.4  Alongtrack  Data 

Aiongtrack  data  is  defined  as  a  series  of  data  values,  each  with  an  associated  geographic 
position.  Data  values  can  be  either  a  scalar  value  u.e.  sediment  thickness.)  or  a  descriptive  string 
(i.e.  Di  edge  Site  n 6  ).  Alongtrack  data  can  be  stored  in  a  separate  file  consisting  of  positions  and 
values,  or  can  be  extracted  from  files  that  contain  multiple  data  values  per  position. 

The  currently  defined  alongtrack  attributes  consist  ot 

At  k  .  very: .:  on  :  Must  be  the  first  line  of  the  attribute  file.  Currently  set  to 

’  v  1 .0". 

At:  k  .  ]  At-. : .:v.a:r. :  The  minimum  (southern)  geodetic  latitude  limit  of  the  data. 

\  allies  less  than  this  value  will  not  be  used.  Value  is  signed, 
decimal  degrees. 

At  k  .  .1  on!-:.: :  The  minimum  (western)  geodetic  longitude  limit  of  the 

data.  Values  less  than  this  value  will  not  be  used.  Value  is 
signed,  decimal  degrees. 

At  k  .  .1  at  i-G: :v.;:r. :  The  maximum  (northern)  geodetic  latitude  limit  of  the  data. 
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Values  greater  than  this  value  will  not  be  used.  Value  is 
signed,  decimal  degrees. 

Atk .  lonMinimum :  The  maximum  (eastern)  geodetic  longitude  limit  of  the 

data.  Values  greater  than  this  value  will  not  be  used.  Value 
is  signed,  decimal  degrees. 

Atk  .  valueMinimum:  The  minimum  value  in  the  domain  of  scalar  values.  Value  is 

signed,  floating  point  value. 

Atk  .  valueMaximum :  The  maximum  value  is  the  domain  of  scalar  values.  Value  is 

signed,  floating  point  value. 

Atk  .  valueName  :  Character  string  describing  the  scalar  values.  To  be  used  for 

labelling  purposes. 

Atk  .  valueUnits  :  Character  string  describing  the  units  of  the  scalar  values. 

Atk  .  type  :  Specifies  the  type  of  alongtrack  data.  Valid  attributes  are 

"Value"  for  scalar  values,  or  "String"  for  character  string 
values. 

At  k .  f  o  rmat :  Specifies  the  format  of  alongtrack  data.  Allowable  values 

are: 

ASCII  Values  are  in  simple  ASCII  format,  consisting  of  latitude 
(decimal  degrees),  longitude  (decimal  degrees),  and  value 
(either  floating  point  value  or  character  string),  each 
separated  by  whitespace,  and  terminated  by  a  newline. 
binary  Values  are  in  binary  format,  consisting  of  latitude  (double 
degrees),  longitude  (double  degrees),  and  scalar  value 
(double).  Character  values  are  not  supported  in  binary 
format. 

DSL  Values  are  in  an  ASCII  format  as  supported  by  WHOI  Deep 
Submergence  Laboratory.  This  format  supports  multiple 
data  values  per  position  record. 

MGD  7  7  Values  are  in  "The  Marine  Geophysical  Data  Exchange  Format 
-  MGD77. "  This  format  supports  multiple  data  values  per 
position  record. 

Atk  .  record:  Specifies  which  record  to  use  when  accessing  data  that 

contains  multiple  data  values  per  position.  This  value  is 
dependant  on  the  format  of  the  data. 

for  DSL  format:  The  first  eight  columns  in  this  format  are  fixed.  The 
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tor  t: 


At.  k  .  ]  ar.  Co  1 1: 


At k . Ion  CM 


At  k . va I ueCo 


Atk  .  3  oc: at  ic. 
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A'  >  .  ir-  c  :  attribute  points  to  the  column  number  niter 
the  eighth  column  of  fixed  data.  Use  1  for  the  first  column, 

-  for  the  second,  and  so  forth. 

format:  This  format  contains  multiple  values  per  record.  To  select  a 

value,  set  this  attribute  to: 

1  I  wo-wav  traveltime  in  seconds. 

2  Bathymetry.  corrected  depth  in  meters. 

3  Magnetics.  Total  Field.  1st  sensor. 

4  Magnetics,  Total  Field,  2nd  sensor. 

3  Magnetics  Residua!  Field 

o  Magnetics  Diurnal  Corrrection. 

7  Depth  or  Altitude  of  Lead  Magnetic  Sensor. 

5  Observed  Gravitv. 

u  Lotvos  Correction. 

1 (>  Free-air  Anomalv. 

See  I A'.o  a.v  Cco/M/sm;/  LX;:.;  Lwfuit^c  Format  -  MGD77" 
for  full  specifications  ot  these  values. 

Specifies  which  column  in  a  record  contains  the  floating 
point  latitude  value.  This  attribute  is  only  used  when  the 
format  is  set  to  AC  MI.  The  default  value  is  1.  Column 
numbering  begins  with  1 . 

Specifies  which  column  in  a  record  contains  the  floating 
point  longitude  value.  This  attribute  is  only  used  when  the 
format  is  set  to  AC  CM.  The  default  value  is  2.  Column 
numbering  begins  with  1. 

Specifies  which  column  in  a  record  contains  the  floating 
point  numberic  value  to  be  used  for  display.  This  attribute 
is  only  used  when  the  format  is  set  to  AC  M  . .  The  default 
value  is  3.  Column  numbering  begins  with  1. 

Location  of  the  data  records  relative  to  tire  file  containing 
these  alongtracL  attributes.  Three  possible  values  are: 

•  ■ '  -  Data  records  are  located  within  the  same  file  as  attributes. 

Data  records  begin  after  any  header  information  defined  bv 

er:-  •-  Data  records  are  located  in  a  different  file  that  attributes,  as 
defined  by  attribute  Av  >  .  f  i  Mr  a:  h  and  A:  k  .  C i MNnnio. 

-  - ”  Data  records  are  located  in  multiple  files  outside  of  the 

attribute  file.  1  he  full  path  and  filename  of  each  data  file  are 
located  after  the  end  of  attributes,  one  per  line. 
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Atk .  f  ileName  :  The  file  name  of  the  file  containing  data  records.  This 

attribute  is  only  needed  when  At  k  .  1  o  c  a  t  i  o  n  is  set  to 
External. 

Atk  .  f  ilePath  :  The  path,  or  directory,  name  of  the  file  containing  data 

records.  This  attribute  is  only  needed  when  Atk. location 
is  set  to  External. 

At  k  .  numP  o  i nt  s  :  The  maximum  number  of  data  records  to  be  read  by  this  set 

of  attributes.  If  Atk  .  location  is  set  to  List,  this  value 
should  be  set  to  the  sum  of  data  records  in  all  files.  When 
unsure  of  total  number,  estimate  value  on  high  side  to 
insure  all  values  will  be  read. 

Atk .  headerLength  :  The  number  of  bytes  prior  to  the  beginning  of  the  first  data 

record.  If  no  header  present,  set  value  to  0.  When  the 
attribute  Atk  .  format  is  set  to  MGD7  7,  this  value  is  the 
number  of  lines  to  skip  prior  to  reading  data.  "Full"  MGD77 
file  contain  24  lines.  Some  files,  however,  contain  0  lines. 


6.5  Sidescan  Data 

Sidescan  data  is  not  supported  at  this  time. 


6.6  Image  Data 

Image  data  is  not  supported  at  this  time. 
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Section  7  —  Hardcopy 


I  his  section  describes  the  procedures  necessary  to  produce  hard  copv,  paper-based 
outputs  from  the  MapToo!  program.  At  present,  the  A'.mTcc'  program  onlv  produces  external 
files,  which  the  user  must  further  process  outside  ot  the  Al.m/cc;  program  in  order  to  actually 
generate  hard  copy. 

7.1  PostScript  Output 


The  Map'I  ooI  program  is  capable  of  generating  a  variety  of  styles  ot  PostScript  files, 
depending  on  the  hard  copy  requirement.  Options  for  generating  PostScript  are  set  in  the 
"Map'j’ool  :  Prim  P P  a :  .a  "  pop-up  window,  which  is  invoked  be  choosing  the 
"Print  .  .  .Post  Par  ip:  "  menu  item  from  the  menu  button. 


■  , 

MapTool:  Print  PostScript 

Type: 

j  BUCK  &  Whirs  Coi-r 

Size: 

:  A-0ZO  ?-?i7S  EPS? 

-  Non.- 

Orientation: 

•  L«r:d£C3L:?  Portrait 

Printer: 

s"  * 

Figure  7-1 .  MapToo-1  Pr  r.t  PostScript 


The  following  options  are  available: 


Selects  the  type  of  PostScript  file  to  generate. 
Available  selections  are: 

Produces  PostScript  commands  such  that  color 
values  are  mapped  to  black  and  white  patterns  by 
the  MapToo!  program. 

Produces  PostScript  commands  using  actual  colors 
as  seen  in  the  MapTool  display. 
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Size:  Selects  the  size  of  the  paper  for  the  PostScript  page. 

Allowable  selections  are: 

A-Size  Will  generate  PostScript  commands  for  A-Size  (8.5" 
x  11")  paper. 

B-Size  Will  generate  PostScript  commands  for  B-Size  (11"  x 
17")  paper. 

EPSF-None  Will  generate  Encapsulated  PostScript  commands. 

In  this  case,  there  is  no  absolute  size  specified. 
Rather,  EPSF  files  are  designed  to  be  used  by  other 
graphics  programs,  which  will  determine  size  on 
their  own. 

Determines  the  orientation  of  the  X/Y  axis  with 
respect  to  the  page.  Available  settings  are: 

Produces  PostScript  commands  such  that  default 
printing  or  viewing  will  produce  a  map  oriented 
with  X-axis  (normally  the  longitude)  along  the 
"long"  edge  of  the  paper. 

Produces  PostScript  commands  such  that  default 
printing  or  viewing  will  produce  a  map  oriented 
with  the  Y-axis  (normally  the  latitude)  along  the 
"long"  edge  of  the  paper. 

Selects  the  printer  destination.  Available  settings 
are: 

At  present,  all  PostScript  output  will  be  sent  to  a  file 
defined  by  the  environmental  variable  POST,  as 
described  in  Section  2.2,  "Environmental  Initiation." 
If  this  environment  variable  is  not  set,  then  output 
will  be  sent  to  a  file  named  "POST"  in  the  directory 
from  which  the  MapTool  program  was  started.  In 
either  case,  if  a  file  previously  exists  with  the  same 
name,  the  MapTool  program  will  overwrite  it. 

When  the  correct  settings  have  been  made,  use  the  [SELECT]  button  on  the  mouse  to 
activate  the  [Print]  button  in  the  pop-up  window.  The  PostScript  file  will  then  be  generated.  To 
actually  print  the  PostScript  file  on  a  printer,  use  standard  Unix  printing  commands.  If  this  file 
needs  to  be  saved  for  subsequent  printing  or  viewing,  make  sure  to  move  to  a  different  directory 
or  rename  the  file,  since  the  MapTool  program  will  overwrite  the  file  the  next  time  PostScript 
printing  occurs. 


Printer : 

File  POST  only 


Orientation : 

Landscape 

Portrait 
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7.2  Rasterfile  (Raytheon  Printer)  Output 


The  MapTool  program  is  capable  of  creating  " true-scale"  Sun  rasterfiles.  which  can  be 
used  by  other  programs,  or  printed  on  a  Ravtheon  TDl'-SpO  Continuous  Tone  printer.  The 
generation  of  rasterfiles  is  actual! v  a  two-step  process  (with  a  third  step  when  printing  on  the 
Raytheon  printer).  I  he  first  step  takes  place  inside  the  Mnplool  program.  Options  for  generating 
raster  files  are  set  in  the  1  .  :  mig.lv"  pop-up  window,  which'is  invoked 

by  choosing  the  :  in.:  .  .  .  ■•.  menu  item  from  the  menu  button. 


MapTool:  Print  Rasterfile 


Select  Raster  Dots  Per  Inch: 


Figure  7-2.  Map  Too1  Print  Rasterfi 


The  following  options  are  available: 


C  hoose  the  pixel  densitv  for  the  output 
rasterfile.  \  alid  values  range  from  72  dpi  to 
40b  dpi.  [he  Raytheon  printer  requires  203  dpi 
for  '  true  scale." 


The  size  of  the  output  raster  is  determined  by  two  factors:  ( I )  The  Map  Scale  as  selected 
m  the  "Chart.  T  ::  ope rr  ies  "  pop-up  window,  and  (2 )  the  pixel  density  selected  here  in  the 
t  J  int  Kdi.t  2  .I <;■  pop-up  u  indow.  \\  hen  the  correct  settings  have  been  made,  use  the 
[Sit  it  i  ]  button  on  the  mouse  to  activ  ate  the  |  l’k:\  :  ]  button  in  the  pop-up  windo 


ow. 


The  actual  output  from  this  first  step  is  an  intermediate  file  called  a  m/i/wsr  file.  T  his  file 
contains  a  raster  representation  of  the  map,  in  a  proprietary,  Lniras-derived  format.  The  actual 
file  written  is  derived  from  the  environmental  variable  :.  •  •  aaz,  as  defined  in  Section  2.2, 

'  [environmental  Initiation."  If  this  environmental  variable  has  not  been  defined,  then  the  file 
written  will  be  call  ur.irasr  .  r:::  ,  located  in  whatever  diroctorv  the  MapTool  program  was 
staited.  II  this  file  needs  to  be  saved  for  subsequent  processing,  make  sure  to  move  to  a  different 
directory  or  rename  the  file,  since  the  A  T. .  '  program  will  overwrite  the  file  the  next  time 
RasteiTilc  printing  occurs. 
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Once  the  unirast  file  has  been  created,  use  the  utility  program  "uni2ras"  to  convert  it  to 
a  Sun  rasterfile.  The  device  name  for  Sun  rasterfile  is  "SSUNRAS."  To  run  this  utility  with  the 
proper  device,  invoke  the  program: 

%  uni2ras  -device  SSUNRAS 

in  the  directory  the  unirast  file  was  created.  This  utility  program  will  create  a  Sun  rasterfile  with 
a  name  derived  from  the  environmental  variable  SUNRAS,  as  defined  in  Section  2.2, 
"Environmental  Initiation."  If  this  environmental  variable  has  not  been  defined,  then  the  file 
written  will  be  call  SUNRAS,  located  in  whichever  directory  the  uni2ras  utility  was  run.  Once 
again,  if  this  file  needs  to  be  saved  for  subsequent  processing,  make  sure  to  move  to  a  different 
directory  or  rename  the  file,  since  the  uni2ras  program  will  overwrite  the  file  the  next  time  it  is 
run. 


7.3  Plotfile  (HPGL2)  Output 

The  MapTool  program  is  also  capable  of  generating  Plotfiles  of  drawing  information  that 
can  be  used  to  make  full  resolution,  "true-scale"  maps  on  a  large  format  plotter.  At  present,  only 
HPGL2  formatted  Plotfiles  can  be  generated.  Plotfiles,  as  opposed  to  raster  files,  contain  a 
description  of  the  graphical  elements  (lines,  colors,  text,  etc.)  to  be  displayed  or  plotted.  These 
Plotfiles  may  be  spooled  to  plotters,  using  standard  Unix  printing  commands,  in  order  to 
generate  hard  copy.  Creation  of  the  Plotfile  is  accomplished  from  the  "  MapTo o  1 :  Print 
Plotfile"  pop-up  window,  which  is  invoked  by  choosing  the  "Print.  .  .Plotfile"  m  enu 
item  from  the  "File"  menu  button. 


Figure  7-3.  MapTool  Print  Plot  File 


There  are  no  options  when  generating  Plotfiles,  as  the  map  to  be  drawn  is  fully  described 
by  display  and  data  attributes  selected  in  other  areas.  Use  the  [Select]  button  on  the  mouse  to 
activate  the  [Print]  button  in  the  pop-up  window.  This  will  create  a  Plotfile,  with  a  name  derived 
from  the  environmental  variable  HPGL2,  as  defined  in  Section  2.2,  "Environmental  Initiation."  If 
this  environmental  variable  has  not  been  defined,  then  the  file  written  will  be  call  HPGL2,  located 
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in  whichever  directory  the  A  *.;?■/  e.  •  program  was  run.  It  tins  tile  needs  to  be  saved  tor  subsequent 
processing,  make  sure  to  move  to  a  different  directory  or  rename  the  tile,  since  the  A UipTool 
program  will  overwrite  the  file  the  next  time  I’lotfiie  printing  occurs. 
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Appendix  A  —  Map  Projections 

The  purpose  of  a  map  projection  is  to  represent  all  or  part  of  the  surface  of  the  Earth  on  a 
flat  plane.  This  is  accomplished  by  transforming  coordinates  in  one  reference  system  to  another. 
A  forward  transformation  converts  geodetic  coordinates  (longitude  and  latitude)  to  Cartesian 
coordinates  (X  and  Y).  An  inverse  transformation  converts  Cartesian  coordinates  to  geodetic 
coordinates.  All  transformations  are  governed  by  a  set  of  parameters  that  define  the  relationship 
between  fixed  points  on  the  Earth  and  points  on  a  flat  plane.  Common  parameters  are  shown  in 
Figure  A-l. 


Central  Meridian 


Figure  A-1 .  Common  Map  Projection  Parameters 


It  is  important  to  emphasize  that  knowledge  of  the  projection  parameters  used  in  the 
construction  of  a  transformation  is  essential  if  reproducibility  is  required,  or  if  merging  with 
previous  map-based  information. 


A.1  False  Easting,  False  Northing 

The  parameters  False  Easting  and  False  Northing  are  used  as  offsets  of  the 
transformed  Cartesian  coordinates  (X  and  Y).  These  parameters  are  used  so  that  X,Y  coordinates 
will  fall  into  a  more  convenient  range.  For  example,  with  some  projections,  geodetic  coordinates 
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south  of  the  B a ::  r.  a;:-.-  or  west  of  the  :  .  T  . m  m.  would  normally  transform  to 
negative  Cartesian  coordinate.  It  an  appropriate  ITT.  :  and  /  or  r;  PL::j  is 

applied,  then  all  C  artesian  coordinates  would  be  positive  numbers.  Thus,  it  might  be  said  that  the 
Ful sc  East-  i no  and  al s  ::  are  the  Cartesian  coordinates  assigned  to  the  point  of 

interaction  between  the '  :  ...  ;  a  g_  and  I  l..o. 

Note  that  with  the  UTM  projection,  :■  .  i:.s  is  defined  as  300,01)0  m.  F, , : 

Northing  is  defined  as  0  m  in  the  northern,  hemisphere,  and  1,000.001)  m  in  the  southern 
hemisphere. 


A. 2  Central  Meridian,  Base  Latitude 

Many  map  projections  require  that  a  specific  longitude  and  latitude  be  designated  as  the 
origin  of  projected  coordinates.  For  some  forms  of  cylindrical  projections,  a  meridian  or  parallel 
is  designated  to  be  the  intersection  between  the  Earth  and  a  evlinder  which  is  then  "unrolled"  to 
form  a  flat  plane.  In  any  case,  the  designated  longitude  is  referred  to  as  the  :  ■  mil  r  i  ciiau 
and  the  designated  latitude  is  referred  to  as  the  ~.  sc  s  l.  s;  i-  do.  Some  projections  define  the 
allowable  choices  for  these  parameters.  F’or  example,  with  the  L  TM  projection,  the  LTis-o 
l,.it  itude  is  defined  as  the  Equator,  and  the  r  cl  r;ii an  is  chosen  based  on  the 
longitude  of  the  area  of  interest. 


A.3  Central  Scale  Factor 


No  map  piojection  can  maintain  the  correct  scale  in  all  directions  for  all  points  in  a  map. 
In  oidei  to  compensate  for  this  distortion  and  to  distribute  it  over  the  map  area,  a  scale  factor  is 

applied  to  all  x/v  coordinates,  this  factor,  the  : .  I-'.-; or  c:  ,  is  a  constant,  usually 

set  to  be  close  to  1 . 


A. 4  Ellipsoids 


The  shape  of  the  Earth  for  mapping  purposes  can  be  described  as  an  oblate  ellipsoid  of 
revolution,  or  oblate  spheroid.  I  Iris  is  an  ellipse  rotated  about  its  shorter  axis.  As  technology  has 
changed,  geodesists  have  developed  more  refined  models  and  measurements  of  the  the  two 
principal  radii  (referred  to  as  the  equatorial  and  polar  radius). 

The  following  are  the  ellipsoids  available  with  the  A!.;r7ee/  program: 

Name  Eiiu.iii'ri.;!  -  „■  /’o/.m  R-.iJim.  b  Acre 

1  ?  S  I  p;  l 

Sphere  o. 371,1)00  o,371,0l)i) 
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WGS  1984 
WGS  1972 
International  1924 
Clarke  1880 
Clarke  1866 


6,378,137 

6,378,135 

6,378,388 

6,378,249.1 

6,378,206.4 


6,356,752.3  Same  as  GRS  1980 
6,356,750.5 

6.356.911.9 

6.356.514.9 
6,356,583.8 


A.5  Standard  Parallels 

Conic  projections  require  specifying  latitudes  which  are  true  to  scale  and  free  of 
distortion.  In  some  cases,  the  flat  plane  is  constructed  by  "unrolling"  a  cone  that  intersects  the 
Earth  along  one  or  two  lines  of  constant  latitude.  These  lines  are  referred  to  as  the  Standard 
Parallels.  These  parallels  become  arcs  of  concentric  circles,  which  may  or  may  not  be  equally 
spaced,  depending  on  the  actual  projection  used.  In  general,  these  values  are  selected  to  be  close 
to  the  map  area  of  interest. 


A.6  Projection  Types 

Map  projections  may  be  characterized  in  a  variety  of  ways,  but  are  generally  done  so  by 
the  technique  used  in  the  transformation.  Additionally,  each  general  class  of  projection 
introduces  limitations  in  term  of  distortions,  preservation  of  shapes  and  direction,  and 
appropriate  useage.  The  MapTool  program  supports  three  general  types  of  projections,  which  can 
be  used  with  a  variety  of  data  types. 

Cylindrical  projections  use  the  concept  of  a  cylinder  that  is  "wrapped"  around  the  Earth, 
which  when  "unrolled"  forms  a  flat  plane.  The  cylinder  commonly  intersects  the  Earth  along  a 
meridian  or  parallel,  although  other  oblique  orientations  are  also  possible.  At  present,  the 
MapTool  program  supports  two  common  cylindrical  projections.  The  Mercator  projection  is 
normally  oriented  such  that  the  cylinder  intersects  the  Earth  along  the  Equator,  though  other 
latitudes  are  possible  as  well.  This  type  of  projection  is  well  suited  toThe  Transverse 
Mercator  projection  is  oriented  such  that  the  cylinder  intersects  the  Earth  along  the  map's 
Central  Merdian.  A  special  case  of  the  Transverse  Mercator  projection  is  the  Universal 
Transverse  Mercator  (UTM)  projection.  In  this  case,  the  map  projection  parameters  are 
specified  based  on  the  UTM  Zone  number  of  the  area  of  interest.  Zones  are  six  degrees  of 
longitude  wide,  and  are  numbered  from  1  to  60  proceeding  east  from  the  180th  meridian  from 
Greenwich. 

Conic  projections  use  the  concept  of  a  cone  that  is  placed  at  the  top  of  a  globe  representing 
the  Earth,  the  tip  of  which  is  aligned  with  the  axis  of  the  globe,  and  the  sides  of  the  cone  touching 
or  tangent  to  the  globe  along  specified  parallels.  The  cone  is  "cut"  along  a  specified  meridian,  and 
"unrolled"  to  form  a  flat  plane.  At  present,  the  MapTool  program  supports  Lambert  Conformal 
conic  projection. 
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A  third  category  of  map  projections  are  azimuthal  projections,  which  are  formed  bv  a 
reference  plane  that  is  usually  tangent  to  tire  berth  at  some  point.  Unlike  cvlindrical  or  conic 
projections,  most  azimuthal  projections  maintain  a  true  perspective,  which  is  desireable  when 
display  large  (hemisphere  scale)  area-.  At  present,  the  AUnTee'  program  supports  the 
Azina  it.  ho]  to.  -  pro  or  e  projection. 


A. 7  Natural  Scale  versus  "Inches  per  Degree" 

While  the  Mtip'I  col  program  uses  a  \atiira!  Scale  method  tor  generating  hardcopy,  some 
mapping  systems  use  a  designation  of  inches  Per  Degree’  for  scaling  purposes.  In  general,  this 
scale  is  only  used  for  Mercator  projections,  with  the  value  representing  the  number  of  inches  per 
degree  of  longitude  at  the  equator. 

in  order  to  construct  maps  that  match  ones  made  with  "Inches  per  Degree"  scale,  try  the 
following: 


•  Using  the  Chur:  dp:-:::-:  I’opup  Window,  select  Jd.  emu;  ::  of  rear  o  to 

•  Select  the  appropriate  7  As-  1-  ...  w.p  and  :  .  e  :  These  parameters  will 

not  affect  the  scaling  process. 

•  Select  the  appropriate  A-:.- i.  A  ....  a:.  1  :  In  general,  the  Central 

Meridian  value  should  be  near  the  map  area  The  Base  Latitude  should  be  set  to  c 
(equator). 

•  Select  an  appropriate  i _  .  .  -  5A-.  =  -; ;  l.  This  should  normallv  be  set  to  1. 

•  The  Tea.:  e  to  use  will  be  dependant  on  the  :  1  ■■  :  p  selected.  For  the  wca  -3-1 

ellipsoid,  the  following  table  mav  be  used. 


lin  in'*  per  Degree  Wilura!  Seale 


S-arur.d  Seale  Inehe s  per  Degree 


1 

1 

:4,3S2,n57 

2 

1 

:2,1°  1 ,32° 

4 

1 

:  1 ,0L)5,on4 

8 

I 

:  547, 832 

16 

1 

:273  a*  1 0 

32 

1 

:  1 3  o,P  5  8 

64 

1 

:68,47V 

128 

1 

:  34, 240 

256 

1 

17,1 20 

A, 000, 000 

O.S7o5 

:2, 500,000 

1 .753 1 

.1,000,000 

4.3827 

:500,000 

8.7o53 

•250,000 

17.5300 

100,000 

43.8266 

30.000 

87.653 1 

25,000 

1 75.3063 

10,000 

438.2657 

A. 8  Further  Information 

I  his  appendix  can  only  touch  on  brief  aspects  of  the  art  and  science  of  map  projections. 
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Additional  information  concerning  map  projections  can  be  found  in  the  following: 

Evenden,  G.IV  1983,  "Cartographic  Projection  Procedures  for  the  UNIX  Environment  —  A  User's 
Manual,"  U.S.  Geological  Survey  Open-File  Report  90-284. 

Snyder,  J.P.,  1987,  "Map  Projections  —  A  Working  Manual,"  U.S.  Geological  Survey  Professional 
Paper  1395. 
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Appendix  B  —  Sample  Data  Attribute  Files 


This  Appendix  presents  sample  data  attribute  files.  Additional  sample  files  may  be  found 
in  the  directory  c:  A -  o  ;  ..  .  ;  ,  Note  that  since  some  attributes  are  onlv  valid  when  other 
attributes  are  set,  it  is  impossible  to  present  all  variations  in  a  single  sample. 

B.1  Navigation  Attribute  File  for  MGD77  Data 


A; 


In  this  example,  note  that  the  attribute  ::  o.  . :  e  is  set  to  2 .  This  denotes  that 
the  data  file  is  a  Full  implementation  of .  .  .  ^  ,  and  the  value  ..  ■■  corresponds  to  the'  number  of 

lines  of  infoi  niation  i n  the  data  file  prior  to  data  records.  Some  data  files  pu rporti ne,  to  be  M.  c .  7 
omit  these  first  24  lines.  In  that  case,  the  attribute  ::  ;  .  ...  .  should  be  set  to  C. 

B.2  Navigation  Attribute  File  for  PNSXY  Data 

M,:V  .  V 

to 

r  i. 
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Nav . lonMaximum : 

Nav . timeMinimum: 
Nav . timeMaximum : 

Nav. format : 

Nav . location : 

Nav . utmZone : 

Nav . numPoints : 
Nav . headerLength 
AL 


-46.1 

92/08/05  00:00:00 
92/08/05  23:59:59 

PNSXY 

List 

23 

4500 

0 


/net /test /navigation/ filel .pnsxy 
/net /test /navigation/ file2 .pnsxy 
/net /test / s ample /newFile .xy 
[end-of-f ile] 


In  this  example,  it  is  necessary  to  specify  the  attribute  Nav .  utmZone,  since  the  postion 
data  is  in  cartesian  X/Y  form.  Also,  note  the  use  of  the  value  associated  with  the  attribute 
Nav .  location.  When  set  to  List,  these  attributes  describe  a  list  of  data  files,  and  the  names  of 
these  data  files  are  appended  at  the  end  of  the  attribute  file. 

B.3  Alongtrack  Attribute  File  for  String  Data 


Atk. version:  vl . 0 

Atk  .  lat.Minimum :  24.0 

Atk . lonMinimum :  -47.0 

Atk . latMaximum:  25.0 

Atk . lonMaximum:  -46.1 


Atk . type : 

Atk . format : 
Atk . location : 


String 

ASCII 

Internal 


Atk . numPoints :  5 

Atk . headerLength :  0 


AL 

24.1  -46.2  Dredge  Site  #1 

24.3  -46.9  Dredge  Site  #2 

24.5555  -46.75  Dredge  Site  #3 

24.2  -46.5  Lost  Dredge 
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24.2  -46.501  Recovered  Pinger 

[end-of-f ile] 

In  this  example,  note  the  use  of  the  attribute  At k .  location.  When  set  to  Internal, 
then  the  data  records  described  are  appended  to  the  attribute  file  itself.  Note  also  the  format  of 
the  data  records.  There  are  three  values  per  line  (latitude,  longitude,  and  string),  separated  by 
white-space  (spaces  and/or  tabs). 

B.4  Alongtrack  Attribute  File  for  DSL  Data 

Atk. version:  vl.O 

Atk . latMinimum:  24.0 

Atk . lonMinimum:  -75.0 

Atk . latMaximum :  25.0 

Atk . lonMaximum:  -74.0 

Atk. type:  Value 

Atk . valueMinimum:  0.0 

Atk.valueMaximum:  1000.0 

Atk . valueName :  Widgets 

Atk.valueUnits :  w 

Atk. format:  DSL 

Atk . record:  2 

Atk . location :  External 

Atk . f ileName :  siteB.wdgts 

Atk . filePath :  /data 

Atk . numPoints :  1440 

Atk.headerLength:  0 

AL 

[end-of-file] 

In  this  example,  note  the  use  of  the  attribute  Atk .  record.  When  set  to  2,  this  denotes  the 
use  of  the  second  value  column  from  the  DSL-format  file.  For  this  format,  there  are  presently  eight 
fixed  columns  of  data.  Value  columns  begin  after  these  columns  —  hence,  the  second  value  record 
is  the  tenth  overall  column  of  data. 

B.5  Grid  Attribute  File 

Grd. version : 

Grd. creator: 


DD_GRD_1 . 0 
sfc2grd  Vl.O 
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1 

■  Grd . creationTirae : 

Aug  17  1992  05:15:01 

Grd . name : 

SRP  Interpolated  Bathymetry 

U  Grd. source: 

Foobar 

|  Grd . sourceTime : 

Aug  15  1992  15:58:01 

Grd . comments : 

Gridded  Masked  Interpolated  Bathymetry 

■  Grd. unit: 

meter 

B  Grd . precision : 

6 

Grd . minimumValue : 

1500.000000 

B  Grd . maximumValue : 

5000.000000 

B  Grd . nullValue : 

0.0 

Grd . pro jectionType : 

UTM 

H  Grd . pro jectionEllipsoid 

WGS-84 

■  Grd . pro jectionUTMZone : 

23 

Grd . coordinateUnit : 

meter 

B  Grd . coordinateSense : 

Right-Hand 

™  Grd . coordinateLattice : 

Grid 

Grd.xOrigin: 

0.000000 

■  Grd.yOrigin: 

2800000.000000 

*  Grd.zOrigin: 

0.000000 

Grd.xScale: 

200.000000 

B  Grd.yScale: 

200.000000 

Grd . zScale : 

1.000000 

m  Grd . zRotation : 

0.0 

S  Grd. format: 

Sun  Raster 

Grd . screen : 

True 

M  Grd. type: 

Single 

|  Grd. depth: 

32 

Grd . dimension : 

1 

m  Grd. order: 

Row-Major 

B  Grd.xSize: 

3000 

Grd . ySize : 

1250 

fl  Grd . headerLength : 

800 

B  Grd. location : 

External 

Grd . f ileName : 

ew9208.600  250k. 0  28000 . 200m. hy . super . ras 

B  Grd . f ilePath : 

/ data/ew92 08 /hy sweep/ grid/masked 

B  *L 

[ end-of-f ile ] 

B 

™  Note  that  many  of  the  attributes  described  in  Section  6.3,  Gridded  Data,  are  not  present  in 

this  sample  attribute  file.  Only  those  attributes  known  or  needed  are  required. 

1 

1 
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